Función DsBindToISTGA (ntdsapi.h)

La función DsBindToISTG se enlaza al equipo que contiene el rol generador de topologías de Inter-Site (ISTG) en el dominio del equipo local.

Sintaxis

NTDSAPI_POSTXP DWORD DsBindToISTGA(
  [in, optional] LPCSTR SiteName,
  [out]          HANDLE *phDS
);

Parámetros

[in, optional] SiteName

Puntero a una cadena terminada en null que contiene el nombre del sitio que se usa al enlazar. Si este parámetro es NULL, se usa el sitio del controlador de dominio más cercano.

[out] phDS

Dirección de un valor handle que recibe el identificador de enlace. Para cerrar este identificador, llame a DsUnBind.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error Win32 o RPC en caso contrario. A continuación se muestran códigos de error posibles.

Observaciones

Nota

El encabezado ntdsapi.h define DsBindToISTG como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	ntdsapi.h
biblioteca de	Ntdsapi.lib
DLL de	Ntdsapi.dll

Consulte también

controlador de dominio y funciones de administración de replicación

DsUnBind