/// <summary>
/// The NetrDatabaseSync2 method returns a set of all changes
/// applied to the specified database since its creation.
/// It provides an interface for a BDC to fully synchronize
/// its databases to those of the PDC. Because returning
/// all changes in one call might be prohibitively expensive
/// due to a large amount of data being returned, this
/// method supports retrieving portions of the database
/// changes in a series of calls using a continuation context
/// until all changes are received. It is possible for
/// the series of calls to be terminated prematurely due
/// to external events, such as system restarts. For that
/// reason, the method also supports restarting the series
/// of calls at a particular point specified by the caller.
/// The caller MUST keep track of synchronization progress
/// during the series of calls as detailed in this section.
/// Opnum: 16
/// </summary>
/// <param name="PrimaryName">
/// The custom RPC binding handle, as specified in section
/// , that represents the connection to the PDC.
/// </param>
/// <param name="ComputerName">
/// The null-terminated Unicode string that contains the
/// NetBIOS name of the BDC calling this method.
/// </param>
/// <param name="Authenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure, as
/// specified in section , that contains the client authenticator.
/// </param>
/// <param name="ReturnAuthenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure, as
/// specified in section , that contains the server return
/// authenticator.
/// </param>
/// <param name="DatabaseID">
/// The identifier for a specific database for which the
/// changes are requested. It MUST be one of the following
/// values.
/// </param>
/// <param name="RestartState">
/// Specifies whether this is a restart of the series of
/// the synchronization calls and how to interpret SyncContext.
/// This value MUST be NormalState unless this is the restart,
/// in which case the value MUST be set as specified in
/// the description of the SyncContext parameter.
/// </param>
/// <param name="SyncContext">
/// Specifies context needed to continue the operation.
/// The value MUST be set to zero on the first call. The
/// caller MUST treat this as an opaque value, unless this
/// call is a restart of the series of synchronization
/// calls. The value returned is to be used on input for
/// the next call in the series of synchronization calls. If
/// this call is the restart of the series, the values
/// of the RestartState and the SyncContext parameters
/// are dependent on the DeltaType value received on the
/// last call before the restart and MUST be set as follows.
/// Find the last NETLOGON_DELTA_ENUM structure in the
/// DeltaArray parameter of the call. The DeltaType field
/// of this NETLOGON_DELTA_ENUM structure, as specified
/// in section , is the DeltaType needed for the restart.
/// The values of RestartState and SyncContext are then
/// determined from the following table. DeltaTypeRestartStateSyncContextAddOrChangeGroupGroupStateThe
/// value of the RID field of the last element AddOrChangeUserUserStateThe
/// value of the RID field of the last element ChangeGroupMembershipGroupMemberStateThe
/// value of the RID field of the last element AddOrChangeAliasAliasState0x00000000ChangeAliasMembershipAliasMemberState0x00000000Any
/// other value not previously listedNormalState0x00000000
/// </param>
/// <param name="DeltaArray">
/// A pointer to a NETLOGON_DELTA_ENUM_ARRAY structure,
/// as specified in section , that contains an array of
/// enumerated changes (deltas) to the specified database.
/// </param>
/// <param name="PreferredMaximumLength">
/// The value that specifies the preferred maximum size,
/// in bytes, of data referenced in the DeltaArray parameter.
/// This is not a hard upper limit, but serves as a guide
/// to the server. The server SHOULDwindows stops including
/// elements in the returned DeltaArray once the size of
/// the returned data equals or exceeds the value of the
/// PreferredMaximumLength parameter. The server SHOULD stop including elements
/// in the returned DeltaArray once the size of the returned
/// data equals or exceeds the value of the PreferredMaximumLength
/// parameter. It is up to the client implementation to
/// choose the value for this parameter.
/// </param>
public NtStatus NetrDatabaseSync2(
string PrimaryName,
string ComputerName,
_NETLOGON_AUTHENTICATOR? Authenticator,
ref _NETLOGON_AUTHENTICATOR? ReturnAuthenticator,
DatabaseID_Values DatabaseID,
_SYNC_STATE RestartState,
ref uint? SyncContext,
out _NETLOGON_DELTA_ENUM_ARRAY? DeltaArray,
uint PreferredMaximumLength)
{
const ushort opnum = 16;
byte[] requestStub;
byte[] responseStub;
Int3264[] paramList;
int retVal;
SafeIntPtr pPrimaryName = Marshal.StringToHGlobalUni(PrimaryName);
SafeIntPtr pComputerName = Marshal.StringToHGlobalUni(ComputerName);
SafeIntPtr pAuthenticator = TypeMarshal.ToIntPtr(Authenticator);
SafeIntPtr pReturnAuthenticatorIn = TypeMarshal.ToIntPtr(ReturnAuthenticator);
SafeIntPtr pSyncContext = TypeMarshal.ToIntPtr(SyncContext);
paramList = new Int3264[] {
pPrimaryName,
pComputerName,
pAuthenticator,
pReturnAuthenticatorIn,
(uint)DatabaseID,
(uint)RestartState,
pSyncContext,
IntPtr.Zero,
PreferredMaximumLength,
0 // retVal
};
requestStub = RpceStubEncoder.ToBytes(
RpceStubHelper.GetPlatform(),
NrpcRpcStubFormatString.TypeFormatString,
new RpceStubExprEval[] { new RpceStubExprEval(logon__NETLOGON_DELTA_USERExprEval_0000) },
NrpcRpcStubFormatString.ProcFormatString,
NrpcRpcStubFormatString.ProcFormatStringOffsetTable[opnum],
true,
paramList);
rpceClientTransport.Call(opnum, requestStub, rpceTimeout, out responseStub);
using (RpceInt3264Collection outParamList = RpceStubDecoder.ToParamList(
RpceStubHelper.GetPlatform(),
NrpcRpcStubFormatString.TypeFormatString,
new RpceStubExprEval[] { new RpceStubExprEval(logon__NETLOGON_DELTA_USERExprEval_0000) },
NrpcRpcStubFormatString.ProcFormatString,
NrpcRpcStubFormatString.ProcFormatStringOffsetTable[opnum],
true,
responseStub,
paramList))
{
IntPtr pReturnAuthenticatorOut = outParamList[3];
ReturnAuthenticator = TypeMarshal.ToNullableStruct<_NETLOGON_AUTHENTICATOR>(pReturnAuthenticatorOut);
SyncContext = TypeMarshal.ToNullableStruct<uint>(outParamList[6]);
IntPtr pDeltaArray = outParamList[7];
pDeltaArray = Marshal.ReadIntPtr(pDeltaArray);
DeltaArray = TypeMarshal.ToNullableStruct<_NETLOGON_DELTA_ENUM_ARRAY>(pDeltaArray);
retVal = outParamList[9].ToInt32();
}
pPrimaryName.Dispose();
pComputerName.Dispose();
pAuthenticator.Dispose();
pReturnAuthenticatorIn.Dispose();
pSyncContext.Dispose();
return (NtStatus)retVal;
}
/// <summary>
/// Decodes the request stub, and fills the fields of the class
/// </summary>
/// <param name="sessionContext">The session context of the request received</param>
/// <param name="requestStub">The request stub got from RPCE layer</param>
internal override void Decode(NrpcServerSessionContext sessionContext, byte[] requestStub)
{
using (RpceInt3264Collection outParamList = RpceStubDecoder.ToParamList(
RpceStubHelper.GetPlatform(),
NrpcRpcStubFormatString.TypeFormatString,
new RpceStubExprEval[] {
new RpceStubExprEval(NrpcRpcAdapter.logon__NETLOGON_DELTA_USERExprEval_0000) },
NrpcRpcStubFormatString.ProcFormatString,
NrpcRpcStubFormatString.ProcFormatStringOffsetTable[(int)Opnum],
false,
requestStub))
{
PrimaryName = Marshal.PtrToStringUni(outParamList[0]);
ComputerName = Marshal.PtrToStringUni(outParamList[1]);
Authenticator = TypeMarshal.ToNullableStruct<_NETLOGON_AUTHENTICATOR>(outParamList[2]);
ReturnAuthenticator = TypeMarshal.ToNullableStruct<_NETLOGON_AUTHENTICATOR>(outParamList[3]);
DatabaseID = (DatabaseID_Values)outParamList[4].ToUInt32();
SyncContext = TypeMarshal.ToNullableStruct<uint>(outParamList[5]);
PreferredMaximumLength = outParamList[7].ToUInt32();
}
}
/// <summary>
/// The NetrDatabaseSync method is a predecessor to the NetrDatabaseSync2 method,
/// as specified in section 3.5.5.5.2. All parameters of this method have the same
/// meanings as the identically named parameters of the NetrDatabaseSync2 method.
/// Opnum: 8
/// </summary>
/// <param name="PrimaryName">
/// The custom RPC binding handle, as specified in section
/// , representing the connection to the PDC.
/// </param>
/// <param name="ComputerName">
/// The null-terminated Unicode string that contains the
/// NetBIOS name of the BDC calling this method.
/// </param>
/// <param name="Authenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure, as
/// specified in section , that contains the client authenticator.
/// </param>
/// <param name="ReturnAuthenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure, as
/// specified in section , that contains the server return
/// authenticator.
/// </param>
/// <param name="DatabaseID">
/// The identifier for a specific database for which the
/// changes are requested. It MUST be one of the following
/// values.
/// </param>
/// <param name="SyncContext">
/// Specifies context needed to continue the operation.
/// The value MUST be set to zero on the first call. The
/// caller MUST treat this as an opaque value, unless this
/// call is a restart of the series of synchronization
/// calls. The value returned is to be used on input for
/// the next call in the series of synchronization calls. If
/// this call is the restart of the series, the values
/// of the RestartState and the SyncContext parameters
/// are dependent on the DeltaType value received on the
/// last call before the restart and MUST be set as follows.
/// Find the last NETLOGON_DELTA_ENUM structure in the
/// DeltaArray parameter of the call. The DeltaType field
/// of this NETLOGON_DELTA_ENUM structure, as specified
/// in section , is the DeltaType needed for the restart.
/// The values of RestartState and SyncContext are then
/// determined from the following table. DeltaTypeRestartStateSyncContextAddOrChangeGroupGroupStateThe
/// value of the RID field of the last element AddOrChangeUserUserStateThe
/// value of the RID field of the last element ChangeGroupMembershipGroupMemberStateThe
/// value of the RID field of the last element AddOrChangeAliasAliasState0x00000000ChangeAliasMembershipAliasMemberState0x00000000Any
/// other value not previously listedNormalState0x00000000
/// </param>
/// <param name="DeltaArray">
/// A pointer to a NETLOGON_DELTA_ENUM_ARRAY structure,
/// as specified in section , that contains an array of
/// enumerated changes (deltas) to the specified database.
/// </param>
/// <param name="PreferredMaximumLength">
/// The value that specifies the preferred maximum size,
/// in bytes, of data referenced in the DeltaArray parameter.
/// This is not a hard upper limit, but serves as a guide
/// to the server. The server SHOULDwindows stops including
/// elements in the returned DeltaArray once the size of
/// the returned data equals or exceeds the value of the
/// PreferredMaximumLength parameter. The server SHOULD stop including elements
/// in the returned DeltaArray once the size of the returned
/// data equals or exceeds the value of the PreferredMaximumLength
/// parameter. It is up to the client implementation to
/// choose the value for this parameter.
/// </param>
public NtStatus NetrDatabaseSync(
string PrimaryName,
string ComputerName,
_NETLOGON_AUTHENTICATOR? Authenticator,
ref _NETLOGON_AUTHENTICATOR? ReturnAuthenticator,
DatabaseID_Values DatabaseID,
ref uint? SyncContext,
out _NETLOGON_DELTA_ENUM_ARRAY? DeltaArray,
uint PreferredMaximumLength)
{
NtStatus status = rpc.NetrDatabaseSync(
PrimaryName,
ComputerName,
Authenticator,
ref ReturnAuthenticator,
DatabaseID,
ref SyncContext,
out DeltaArray,
PreferredMaximumLength);
context.ConnectionStatus = status;
return status;
}
/// <summary>
/// The NetrDatabaseSync2 method returns a set of all changes
/// applied to the specified database since its creation.
/// It provides an interface for a BDC to fully synchronize
/// its databases to those of the PDC. Because returning
/// all changes in one call might be prohibitively expensive
/// due to a large amount of data being returned, this
/// method supports retrieving portions of the database
/// changes in a series of calls using a continuation context
/// until all changes are received. It is possible for
/// the series of calls to be terminated prematurely due
/// to external events, such as system restarts. For that
/// reason, the method also supports restarting the series
/// of calls at a particular point specified by the caller.
/// The caller MUST keep track of synchronization progress
/// during the series of calls.
/// Opnum: 16
/// </summary>
/// <param name="primaryName">
/// The custom RPC binding handle,
/// that represents the connection to the PDC.
/// </param>
/// <param name="computerName">
/// The null-terminated Unicode string that contains the
/// NetBIOS name of the BDC calling this method.
/// </param>
/// <param name="authenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure,
/// that contains the client authenticator.
/// </param>
/// <param name="returnAuthenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure,
/// that contains the server return
/// authenticator.
/// </param>
/// <param name="databaseID">
/// The identifier for a specific database for which the
/// changes are requested. It MUST be one of the following
/// values.
/// </param>
/// <param name="restartState">
/// Specifies whether this is a restart of the series of
/// the synchronization calls and how to interpret SyncContext.
/// This value MUST be NormalState unless this is the restart,
/// in which case the value MUST be set as specified in
/// the description of the SyncContext parameter.
/// </param>
/// <param name="syncContext">
/// Specifies context needed to continue the operation.
/// The value MUST be set to zero on the first call. The
/// caller MUST treat this as an opaque value, unless this
/// call is a restart of the series of synchronization
/// calls. The value returned is to be used on input for
/// the next call in the series of synchronization calls. If
/// this call is the restart of the series, the values
/// of the RestartState and the SyncContext parameters
/// are dependent on the DeltaType value received on the
/// last call before the restart and MUST be set as follows.
/// Find the last NETLOGON_DELTA_ENUM structure in the
/// DeltaArray parameter of the call. The DeltaType field
/// of this NETLOGON_DELTA_ENUM structure
/// is the DeltaType needed for the restart.
/// The values of RestartState and SyncContext are then
/// determined from the following table.<para/>
/// DeltaType RestartState SyncContext<para/>
/// AddOrChangeGroup GroupState The value of the RID field of the last element<para/>
/// AddOrChangeUser UserState The value of the RID field of the last element<para/>
/// ChangeGroupMembership GroupMemberState The value of the RID field of the last element<para/>
/// AddOrChangeAlias AliasState 0x00000000<para/>
/// ChangeAliasMembership AliasMemberState 0x00000000<para/>
/// Any other value not previously listed NormalState 0x00000000
/// </param>
/// <param name="deltaArray">
/// A pointer to a NETLOGON_DELTA_ENUM_ARRAY structure,
/// that contains an array of
/// enumerated changes (deltas) to the specified database.
/// </param>
/// <param name="preferredMaximumLength">
/// The value that specifies the preferred maximum size,
/// in bytes, of data referenced in the DeltaArray parameter.
/// This is not a hard upper limit, but serves as a guide
/// to the server. The server SHOULDwindows stops including
/// elements in the returned DeltaArray once the size of
/// the returned data equals or exceeds the value of the
/// PreferredMaximumLength parameter. The server SHOULD stop including elements
/// in the returned DeltaArray once the size of the returned
/// data equals or exceeds the value of the PreferredMaximumLength
/// parameter. It is up to the client implementation to
/// choose the value for this parameter.
/// </param>
/// <returns>
/// The method returns 0x00000000 on success;
/// otherwise, it returns a nonzero error code.
/// </returns>
public NtStatus NetrDatabaseSync2(
string primaryName,
string computerName,
_NETLOGON_AUTHENTICATOR? authenticator,
ref _NETLOGON_AUTHENTICATOR? returnAuthenticator,
DatabaseID_Values databaseID,
_SYNC_STATE restartState,
ref uint? syncContext,
out _NETLOGON_DELTA_ENUM_ARRAY? deltaArray,
uint preferredMaximumLength)
{
NtStatus status = rpc.NetrDatabaseSync2(
primaryName,
computerName,
authenticator,
ref returnAuthenticator,
databaseID,
restartState,
ref syncContext,
out deltaArray,
preferredMaximumLength);
context.ConnectionStatus = status;
return status;
}
/// <summary>
/// The NetrDatabaseDeltas method returns a set of changes (or deltas)
/// performed to the SAM, SAM built-in, or LSA databases after a particular
/// value of the database serial number. It is used by BDCs to request
/// database changes from the PDC that are missing on the BDC. Opnum: 7
/// </summary>
/// <param name="PrimaryName">
/// The custom RPC binding handle (as specified in section 3.5.5.1) that
/// represents the connection to the PDC.
/// </param>
/// <param name="ComputerName">
/// The null-terminated Unicode string that contains the NetBIOS name of
/// the BDC calling this method.
/// </param>
/// <param name="Authenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure that contains the
/// client authenticator.
/// </param>
/// <param name="ReturnAuthenticator">
/// A pointer to a NETLOGON_AUTHENTICATOR structure that contains the
/// server return authenticator.
/// </param>
/// <param name="DatabaseID">
/// The identifier for a specific account database set as follows:
/// 0x00000000
/// Indicates the SAM database.
/// 0x00000001
/// Indicates the SAM built-in database.
/// 0x00000002
/// Indicates the LSA database.
/// </param>
/// <param name="DomainModifiedCount">
/// A pointer to an NLPR_MODIFIED_COUNT structure, as specified in section
/// 2.2.1.5.26, that contains the database serial number. On input, this is
/// the value of the database serial number on the client. On output, this is
/// the value of the database serial number corresponding to the last element
/// (delta) returned in the DeltaArray parameter.
/// </param>
/// <param name="DeltaArray">
/// A pointer to a NETLOGON_DELTA_ENUM_ARRAY structure that contains an array
/// of enumerated changes (deltas) to the specified database with database
/// serial numbers larger than the database serial number value specified in
/// the input value of the DomainModifiedCount parameter.
/// </param>
/// <param name="PreferredMaximumLength">
/// The value that specifies the preferred maximum size, in bytes, of data to
/// return in the DeltaArray parameter. This is not a hard upper limit, but
/// serves as a guide to the server. The server SHOULD stop including
/// elements in the returned DeltaArray after the size of the returned data
/// equals or exceeds the value of the PreferredMaximumLength parameter. It is
/// up to the client implementation to choose the value for this parameter.
/// </param>
public NtStatus NetrDatabaseDeltas(
string PrimaryName,
string ComputerName,
_NETLOGON_AUTHENTICATOR? Authenticator,
ref _NETLOGON_AUTHENTICATOR? ReturnAuthenticator,
DatabaseID_Values DatabaseID,
ref _NLPR_MODIFIED_COUNT? DomainModifiedCount,
out _NETLOGON_DELTA_ENUM_ARRAY? DeltaArray,
uint PreferredMaximumLength)
{
NtStatus status = rpc.NetrDatabaseDeltas(
PrimaryName,
ComputerName,
Authenticator,
ref ReturnAuthenticator,
DatabaseID,
ref DomainModifiedCount,
out DeltaArray,
PreferredMaximumLength);
context.ConnectionStatus = status;
return status;
}
