3.1.4.1.1 NetrDfsManagerInitialize (Opnum 14)

The NetrDfsManagerInitialize method instructs the DFS server to discard its current state and reinitialize itself from its stored configuration settings. The server SHOULD<35> choose to implement this method.

The NetrDfsManagerInitialize method has the following Microsoft Interface Definition Language (MIDL) syntax.

 NET_API_STATUS NetrDfsManagerInitialize(
   [in, string] WCHAR* ServerName,
   [in] DWORD Flags
 );

ServerName: The pointer to a null-terminated Unicode host name string of the DFS root target server or DC where the DFS service is to be reinitialized.

Flags: This parameter MUST be zero.

Return Values: The method MUST return 0 on success and a nonzero error code on failure. The method can return any specific error code value, as specified in [MS-ERREF] section 2.2. The most common error codes are listed in the following table.

Return value/code

Description

0x00000000

ERROR_SUCCESS

Successful completion.

0x00000005

ERROR_ACCESS_DENIED

Permission to perform the operation was denied.

0x00000032

ERROR_NOT_SUPPORTED

Server does not support the requested operation.

If this method is implemented, the DFS server SHOULD<36> discard its current state and reinitialize itself from its stored configuration settings.