5.41 DRS_OPTIONS
DRS_OPTIONS is a concrete type for a set of options sent to and received from various drsuapi methods.
This type is declared as follows:
-
typedef unsigned long DRS_OPTIONS;
It is a bit field, presented in little-endian byte order, that contains the following values.
Seven elements of the set are interpreted differently by different methods; such elements have multiple symbolic names.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
M R |
P S |
I S |
W R |
A L L / D R |
A R |
G C / U N |
A S |
F S / N S |
S N / R F |
N R R |
G S / L O |
G A |
C O |
T S |
A S R / I E |
I S N |
S S |
N S Y |
R G / N D |
S U |
S Q |
F S P |
F S I |
G P |
S P |
N N |
U C |
D P S |
D A S |
S F |
P E |
X: Unused. MUST be zero and ignored.
AS (DRS_ASYNC_OP, 0x00000001): Perform the operation asynchronously.
GC (DRS_GETCHG_CHECK, 0x00000002): Treat ERROR_DS_DRA_REF_NOT_FOUND and ERROR_DS_DRA_REF_ALREADY_EXISTS as success for calls to IDL_DRSUpdateRefs (section 4.1.26).
UN (DRS_UPDATE_NOTIFICATION, 0x00000002): Identifies a call to IDL_DRSReplicaSync that was generated due to a replication notification. See [MS-ADTS] section 3.1.1.5.1.6 for more details on replication notifications. This flag is ignored by the server.
AR (DRS_ADD_REF, 0x00000004): Register a client DC for notifications of updates to the NC replica.
ALL (DRS_SYNC_ALL, 0x00000008): Replicate from all server DCs.
DR (DRS_DEL_REF, 0x00000008): Deregister a client DC from notifications of updates to the NC replica.
WR (DRS_WRIT_REP, 0x00000010): Replicate a writable replica, not a read-only partial replica or read-only full replica.
IS (DRS_INIT_SYNC, 0x00000020): Perform replication at startup.
PS (DRS_PER_SYNC, 0x00000040): Perform replication periodically.
MR (DRS_MAIL_REP, 0x00000080): Perform replication using SMTP as a transport.
ASR (DRS_ASYNC_REP, 0x00000100): Populate the NC replica asynchronously.
IE (DRS_IGNORE_ERROR, 0x00000100): Ignore errors.
TS (DRS_TWOWAY_SYNC, 0x00000200): Inform the server DC to replicate from the client DC.
CO (DRS_CRITICAL_ONLY, 0x00000400): Replicate only system-critical objects.
GA (DRS_GET_ANC, 0x00000800): Include updates to ancestor objects before updates to their descendants.
GS (DRS_GET_NC_SIZE, 0x00001000): Get the approximate size of the server NC replica.
LO (DRS_LOCAL_ONLY, 0x00001000): Perform the operation locally without contacting any other DC.
NRR (DRS_NONGC_RO_REP, 0x00002000): Replicate a read-only full replica. Not a writable or partial replica.
SN (DRS_SYNC_BYNAME, 0x00004000): Choose the source server by network name.
RF (DRS_REF_OK, 0x00004000): Allow the NC replica to be removed even if other DCs use this DC as a replication server DC.
FS (DRS_FULL_SYNC_NOW, 0x00008000): Replicate all updates in the replication cycle, even those that would normally be filtered.
NS (DRS_NO_SOURCE, 0x00008000): The NC replica has no server DCs.
FSI (DRS_FULL_SYNC_IN_PROGRESS, 0x00010000): When the flag DRS_FULL_SYNC_NOW is received in a call to IDL_DRSReplicaSync, the flag DRS_FULL_SYNC_IN_PROGRESS is sent in the associated calls to IDL_DRSGetNCChanges until the replication cycle completes. This flag is ignored by the server.
FSP (DRS_FULL_SYNC_PACKET, 0x00020000): Replicate all updates in the replication request, even those that would normally be filtered.
SQ (DRS_SYNC_REQUEUE, 0x00040000): This flag is specific to the Microsoft client implementation of IDL_DRSGetNCChanges. It is used to identify whether the call was placed in the replicationQueue more than once due to implementation-specific errors. This flag is ignored by the server.
SU (DRS_SYNC_URGENT, 0x00080000): Perform the requested replication immediately; do not wait for any timeouts or delays. For information about urgent replication, see [MS-ADTS] section 3.1.1.5.1.7.
RG (DRS_REF_GCSPN, 0x00100000): Requests that the server add an entry to repsTo for the client on the root object of the NC replica that is being replicated. When repsTo is set using this flag, the notifying client DC contacts the server DC using the service principal name that begins with "GC" (section 2.2.3.2).
ND (DRS_NO_DISCARD, 0x00100000): This flag is specific to the Microsoft implementation. It identifies when the client DC is to call the requested IDL_DRSReplicaSync method individually, without overlapping other outstanding calls to IDL_DRSReplicaSync. This flag is ignored by the server.
NSY (DRS_NEVER_SYNCED, 0x00200000): There is no successfully completed replication from this source server.
SS (DRS_SPECIAL_SECRET_PROCESSING, 0x00400000): Do not replicate attribute values of attributes that contain secret data.
ISN (DRS_INIT_SYNC_NOW, 0x00800000): Perform initial replication now.
PE (DRS_PREEMPTED, 0x01000000): The replication attempt is preempted by a higher priority replication request.
SF (DRS_SYNC_FORCED, 0x02000000): Force replication, even if the replication system is otherwise disabled.
DAS (DRS_DISABLE_AUTO_SYNC, 0x04000000): Disable replication induced by update notifications.
DPS (DRS_DISABLE_PERIODIC_SYNC, 0x08000000): Disable periodic replication.
UC (DRS_USE_COMPRESSION, 0x10000000): Compress response messages.
NN (DRS_NEVER_NOTIFY, 0x20000000): Do not send update notifications.
SP (DRS_SYNC_PAS, 0x40000000): Expand the partial attribute set of the partial replica.
GP (DRS_GET_ALL_GROUP_MEMBERSHIP, 0x80000000): Replicate all kinds of group membership. If this flag is not present nonuniversal group membership will not be replicated.
For information about the Windows versions in which these flags were introduced, supported, or deprecated, see the following behavior note.<47>