Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

3.5.4.3.4 NetrGetDCName (Opnum 11)

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

NET_API_STATUS NetrGetDCName(
  [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 3.5.4.1, 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.<223>

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<224> 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.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.