SCHEDULE

The SCHEDULE structure is a variable-length structure used with the DsReplicaAdd and DsReplicaModify functions to contain replication schedule data for a replication source.

typedef struct _SCHEDULE {

  ULONG Size;

  ULONG Bandwidth;

  ULONG NumberOfSchedules;

  SCHEDULE_HEADER Schedules[1];
} SCHEDULE, *PSCHEDULE;

Members

Size

Contains the size, in bytes, of the SCHEDULE structure, including the size of all of the elements and data of the Schedules array.

Bandwidth

Not used.

NumberOfSchedules

Contains the number of elements in the Schedules array.

Schedules

Contains an array of SCHEDULE_HEADER structures that contain the replication schedule data for the replication source. The NumberOfSchedules member contains the number of elements in this array. Currently, this array can only contain one element.

Example Code [C++]

The following code example demonstrates the proper technique for calculating the Size member of this structure.

[C++]
#define SCH_HEADER_COUNT 1

// Add the size of the SCHEDULE structure, which includes one SCHEDULE_HEADER structure.
DWORD dwSize = sizeof(SCHEDULE); 

// Add the size of all of the SCHEDULE_HEADER structures exclusive of the first structure.
dwSize += (SCH_HEADER_COUNT - 1) * sizeof(SCHEDULE_HEADER); 

// Add the size of the SCHEDULE_HEADER data for all of the structures.
dwSize += SCH_HEADER_COUNT * SCHEDULE_DATA_ENTRIES;

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Schedule.h.

See Also

SCHEDULE_HEADER, DsReplicaAdd, DsReplicaModify