4.1.26 IDL_DRSUpdateRefs (Opnum 4)

  • Article

The IDL_DRSUpdateRefs method adds or deletes a value from the repsTo of a specified NC replica.

 ULONG IDL_DRSUpdateRefs(
   [in, ref] DRS_HANDLE hDrs,
   [in] DWORD dwVersion,
   [in, ref, switch_is(dwVersion)] 
     DRS_MSG_UPDREFS* pmsgUpdRefs
 );

hDrs: The RPC context handle returned by the IDL_DRSBind method.

dwVersion: The version of the request message.

pmsgUpdRefs: A pointer to the request message.

Return Values: 0 if successful, otherwise a Windows error code.

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.