 |
NetGetDCName
..msdn Add comment W32 Constants Translate this page |
|
|
|
Returns the name of the primary domain controller (PDC). It does not return the name of the backup domain controller (BDC) for the specified domain. |
|
|
| Code examples: |
|
|
|
|
|
| Declaration: |
|
|
NET_API_STATUS NetGetDCName(
LPCWSTR servername,
LPCWSTR domainname,
LPBYTE *bufptr
);
|
|
|
|
| FoxPro declaration: |
|
|
DECLARE INTEGER NetGetDCName IN netapi32;
STRING servername,;
STRING domainname,;
INTEGER @ bufptr
|
|
|
|
| Parameters: |
|
servername
[in] Pointer to a constant Unicode string specifying the name of the remote server on which the function is to execute.
domainname
[in] Pointer to a constant Unicode string specifying the name of the domain.
bufptr
[out] Pointer to an allocated buffer that receives a Unicode string which specifies the server name of the PDC of the domain. |
|
|
| Return value: |
|
| If the function succeeds, the return value is NERR_Success (0). |
|
|
| My comment: |
|
Windows NT/2000/XP: Included in Windows NT 3.1 and later.
Windows 95/98/Me: Unsupported.
This buffer is allocated by the system and must be freed using the NetApiBufferFree function.
|
|
|
| Word Index links for the NetGetDCName : |
|
|
|
|
|
| Translate this page: |
|
|
|
|
| • |
|
| Created: | 2001-10-16 23:41:20 | | Modified: | 2001-11-27 22:17:44 |
Visited in last 7 days: 18 |
Retrieving the name of the primary domain controller (PDC) and join status information (NT/2000/XP) 