3.1.4.35 NetrDfsGetVersion (Opnum 43)

  • Article

The NetrDfsGetVersion method checks whether the server is a DFS server and if so, returns the DFS version. An implementation MAY<127> choose to support this method.

 NET_API_STATUS NetrDfsGetVersion(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [out] DWORD* Version
 );

ServerName: An SRVSVC_HANDLE (section 2.2.1.1) pointer that identifies the server. The client MUST map this structure to an RPC binding handle (see [C706] sections 4.3.5 and 5.1.5.2). The server MUST ignore this parameter.

Version: A pointer to a DWORD where the server returns the DFS version.

Return Values: The method returns 0x00000000 (NERR_Success) to indicate success; otherwise, it returns a nonzero error code. The method can take any specific error code value, as specified in [MS-ERREF] section 2.2.

In response to a NetrDfsGetVersion message, the server SHOULD<128> choose to perform no processing and return an implementation-specific error code when this method is called. If the server supports DFS, the server MAY return the DFS version number that is in use on the server.

The Version parameter is a pointer to a DWORD. If the server supports DFS, the server MUST set this parameter to an implementation-specific<129> DFS version number that the server supports.

The server MAY<130> enforce security measures to verify that the server enforces these security measures and that the caller has the required permissions to execute this call. If the caller does not have the required credentials, the server SHOULD<131> fail the call.