Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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.

Return codeDescription
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 2003

Header

Ntdsapi.h

Library

Ntdsapi.lib

DLL

Ntdsapi.dll

Unicode and ANSI names

DsBindToISTGW (Unicode) and DsBindToISTGA (ANSI)

See also

DsUnBind
Domain Controller and Replication Management Functions

 

 

Show:
© 2015 Microsoft