3.1.4.21 NetrRemoteTOD (Opnum 28)

The NetrRemoteTOD method returns the time of day information on a server.

 NET_API_STATUS NetrRemoteTOD(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [out] LPTIME_OF_DAY_INFO* BufferPtr
 );

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.

BufferPtr: A pointer to a structure of type TIME_OF_DAY_INFO where the information is returned.

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 NetrRemoteTOD message, the server MUST return the time of day information or return an error code.

The server MUST return the time of day information on the server in the BufferPtr parameter in the format of the LPTIME_OF_DAY_INFO structure, as specified in section 2.2.4.105.

The server SHOULD<90> enforce security measures to verify that the caller has the required permissions to execute this routine. If the caller does not have the required credentials, the server SHOULD<91> fail the call.