Compartilhar via

Função DsListDomainsInSiteA (ntdsapi.h)

  • Artigo

A função DsListDomainsInSite lista todos os domínios em um site.

Sintaxe

NTDSAPI DWORD DsListDomainsInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppDomains
);

Parâmetros

[in] hDs

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

[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] ppDomains

Ponteiro para um ponteiro para uma estrutura DS_NAME_RESULT que recebe a lista de domínios no site. Para liberar a estrutura retornada, chame a função DsFreeNameResult .

Retornar valor

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

Comentários

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

Observação

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

DS_NAME_RESULT

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

DsFreeNameResult