Compartilhar via

Função DsListInfoForServerA (ntdsapi.h)

  • Artigo

A função DsListInfoForServer lista dados diversos para um servidor.

Sintaxe

NTDSAPI DWORD DsListInfoForServerA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           server,
  [out] PDS_NAME_RESULTA *ppInfo
);

Parâmetros

[in] hDs

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

[in] server

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do servidor. Esse nome deve ser o mesmo que uma das cadeias de caracteres retornadas pela função DsListServersForDomainInSite ou DsListServersInSite .

[out] ppInfo

Ponteiro para uma variável que recebe um ponteiro para uma estrutura DS_NAME_RESULT que contém os dados do servidor. A estrutura retornada deve ser desalocada usando DsFreeNameResult.

Os índices da matriz na estrutura DS_NAME_RESULT indicam quais dados estão contidos por cada elemento de matriz. As constantes a seguir podem ser usadas para especificar o índice desejado para uma determinada parte dos dados.

DS_LIST_ACCOUNT_OBJECT_FOR_SERVER

Nome do objeto de conta para o controlador de domínio (DC).

DS_LIST_DNS_HOST_NAME_FOR_SERVER

Nome do host DNS do DC.

DS_LIST_DSA_OBJECT_FOR_SERVER

GUID do agente de serviço de diretório (DSA) para o controlador de domínio (DC).

Retornar valor

Se a função retornar dados do servidor, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir.

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 DsListInfoForServer 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