Função DsListServersForDomainInSiteA (ntdsapi.h)

Artigo
11/20/2024

A função DsListServersForDomainInSite lista todos os servidores em um domínio em um site.

Sintaxe

NTDSAPI DWORD DsListServersForDomainInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           domain,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppServers
);

Parâmetros

[in] hDs

Contém um identificador de serviço de diretório obtido da função DSBind ou DSBindWithCred.

[in] domain

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de domínio. Essa cadeia de caracteres deve ser a mesma que uma das cadeias de caracteres retornadas por função DsListDomainsInSite.

[in] site

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do site. Essa cadeia de caracteres é retirada da lista de nomes de site retornados pela função DsListSites.

[out] ppServers

Ponteiro para um ponteiro para uma estrutura DS_NAME_RESULT que recebe a lista de servidores no domínio. A estrutura retornada deve ser liberada usando a função DsFreeNameResult.

Valor de retorno

Se a função retornar uma lista de servidores, o valor retornado será NO_ERROR. Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Observações

Erros de conversão de nome individual são relatados na estrutura de DS_NAME_RESULT retornada.

Nota

O cabeçalho ntdsapi.h define DsListServersForDomainInSite 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

DS_NAME_RESULT

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

DsFreeNameResult

Compartilhar via