Compartilhar via


Função DsBindToISTGA (ntdsapi.h)

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 HANDLE valor que recebe o identificador de associação. Para fechar esse identificador, chame DsUnBind.

Valor de retorno

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista
servidor com suporte mínimo Windows Server 2008
da Plataforma de Destino Windows
cabeçalho ntdsapi.h
biblioteca Ntdsapi.lib
de DLL Ntdsapi.dll

Consulte também

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

DsUnBind