Função DsListInfoForServerA (ntdsapi.h)
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
Funções de gerenciamento de replicação e controlador de domínio