Função DsListRolesA (ntdsapi.h)

A função DsListRoles lista as funções reconhecidas pelo servidor.

Sintaxe

NTDSAPI DWORD DsListRolesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppRoles
);

Parâmetros

[in] hDs

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

[out] ppRoles

Ponteiro para uma variável que recebe um ponteiro para uma estrutura de DS_NAME_RESULT que contém as funções que o servidor reconhece. 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_ROLE_DOMAIN_OWNER

O servidor é proprietário do domínio.

DS_ROLE_INFRASTRUCTURE_OWNER

O servidor é proprietário da infraestrutura.

DS_ROLE_PDC_OWNER

O servidor é proprietário do PDC.

DS_ROLE_RID_OWNER

O servidor é proprietário do RID.

DS_ROLE_SCHEMA_OWNER

O servidor é proprietário do esquema.

Valor de retorno

Se a função retornar uma lista de funções, o valor retornado será NO_ERROR.

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

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

Observações

Nota

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