NetrGetDCName (Opnum 11)

The NetrGetDCName method<224> retrieves the NetBIOS name of the PDC for the specified domain.

   [in, string] LOGONSRV_HANDLE ServerName,
   [in, unique, string] wchar_t* DomainName,
   [out, string] wchar_t** Buffer

ServerName: The custom RPC binding handle, as specified in section, that represents the connection to a domain controller.

DomainName: A null-terminated Unicode string that specifies the NetBIOS name of the domain.

Buffer: A pointer to a null-terminated Unicode string that contains the NetBIOS name of the PDC for the specified domain. The server name returned by this method is prefixed by two backslashes (\\).

Return Values: The method returns 0x00000000 on success; otherwise, it returns a nonzero error code.<225>

If the DomainName parameter is not NULL and is not a valid NetBIOS name format, the server MUST return NERR_DCNotFound.

The server MUST attempt to locate a PDC for the domain specified by the client. The server MUST return NERR_DCNotFound if the PDC could not be located for the specified domain. The server MAY<226> implement alternate means of locating DCs: for example, a static list in a file, or two methods detailed in [MS-ADTS] section 6.3.6.

NetrGetDcName returns the name of the discovered PDC.