Função DsBindToISTGA (ntdsapi.h)

  • Artigo

A função DsBindToISTG associa-se ao computador que contém a função ISTG (Gerador de Topologia Inter-Site) no domínio do computador local.

Sintaxe

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

Parâmetros

[in, optional] SiteName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do site usado ao associar. Se esse parâmetro for NULL, o site do controlador de domínio mais próximo será usado.

[out] phDS

Endereço de um valor HANDLE que recebe o identificador de associação. Para fechar esse identificador, chame DsUnBind.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro Win32 ou RPC, caso contrário. Veja a seguir possíveis códigos de erro.

Comentários

Observação

O cabeçalho ntdsapi.h define DsBindToISTG como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho ntdsapi.h
Biblioteca Ntdsapi.lib
DLL Ntdsapi.dll

Confira também

Funções de gerenciamento de replicação e controlador de domínio

DsUnBind