4.1.2 IDL_DRSAddSidHistory (Opnum 20)
The IDL_DRSAddSidHistory method adds one or more SIDs to the sIDHistory attribute of a given object.
-
ULONG IDL_DRSAddSidHistory( [in, ref] DRS_HANDLE hDrs, [in] DWORD dwInVersion, [in, ref, switch_is(dwInVersion)] DRS_MSG_ADDSIDREQ* pmsgIn, [out, ref] DWORD* pdwOutVersion, [out, ref, switch_is(*pdwOutVersion)] DRS_MSG_ADDSIDREPLY* pmsgOut );
hDrs: RPC context handle returned by the IDL_DRSBind method.
dwInVersion: Version of the request message. Must be set to 1, because no other version is supported.
pmsgIn: Pointer to the request message.
pdwOutVersion: Pointer to the version of the response message. The value must be 1, because no other version is supported.
pmsgOut: Pointer to the response message.
Return Values: 0 or one of the following Windows error codes: ERROR_DS_MUST_RUN_ON_DST_DC or ERROR_INVALID_PARAMETER.
Exceptions Thrown: This method might throw the following exceptions beyond those thrown by the underlying RPC protocol (as specified in [MS-RPCE]): ERROR_INVALID_HANDLE, ERROR_DS_DRS_EXTENSIONS_CHANGED, ERROR_DS_DIFFERENT_REPL_EPOCHS, and ERROR_INVALID_PARAMETER.