Função DsListRolesW (ntdsapi.h)

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

Sintaxe

NTDSAPI DWORD DsListRolesW(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTW *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

Requisitos

Consulte também

DS_NAME_RESULT

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

DsFreeNameResult