DsListServersForDomainInSite function
The DsListServersForDomainInSite function lists all the servers in a domain in a site.
Syntax
DWORD DsListServersForDomainInSite( _In_ HANDLE hDs, _In_ LPTSTR domain, _In_ LPTSTR site, _Out_ PDS_NAME_RESULT *ppServers );
Parameters
- hDs [in]
-
Contains a directory service handle obtained from either the DSBind or DSBindWithCred function.
- domain [in]
-
Pointer to a null-terminated string that specifies the domain name. This string must be the same as one of the strings returned by DsListDomainsInSite function.
- site [in]
-
Pointer to a null-terminated string that specifies the site name. This string is taken from the list of site names returned by the DsListSites function.
- ppServers [out]
-
Pointer to a pointer to a DS_NAME_RESULT structure that receives the list of servers in the domain. The returned structure must be freed using the DsFreeNameResult function.
Return value
If the function returns a list of servers, the return value is NO_ERROR. If the function fails, the return value can be one of the following error codes.
- ERROR_INVALID_PARAMETER
-
A parameter is invalid.
- ERROR_NOT_ENOUGH_MEMORY
-
There is insufficient memory available.
Remarks
Individual name conversion errors are reported in the returned DS_NAME_RESULT structure.
Requirements
|
Minimum supported client |
Windows Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
DsListServersForDomainInSiteW (Unicode) and DsListServersForDomainInSiteA (ANSI) |
See also