Função DsListInfoForServerA (ntdsapi.h)

Artigo
11/20/2024

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 função DsListServersInSite.

[out] ppInfo

Ponteiro para uma variável que recebe um ponteiro para uma estrutura de 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 um determinado pedaço de 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).

Valor de retorno

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