DsBindToISTG function
The DsBindToISTG function binds to the computer that holds the Inter-Site Topology Generator (ISTG) role in the domain of the local computer.
Syntax
DWORD WINAPI DsBindToISTG( _In_opt_ LPCTSTR SiteName, _Out_ HANDLE *phDS );
Parameters
- SiteName [in, optional]
-
Pointer to a null-terminated string that contains the site name used when binding. If this parameter is NULL, the site of the nearest domain controller is used.
- phDS [out]
-
Address of a HANDLE value that receives the bind handle. To close this handle, call DsUnBind.
Return value
Returns ERROR_SUCCESS if successful or a Win32 or RPC error code otherwise. The following are possible error codes.
- ERROR_INVALID_PARAMETER
-
The phDS parameter is invalid.
- ERROR_NOT_ENOUGH_MEMORY
-
A memory allocation failure occurred.
Requirements
|
Minimum supported client |
Windows Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
DsBindToISTGW (Unicode) and DsBindToISTGA (ANSI) |
See also