Método ICertAdmin2::GetMyRoles (certadm.h)

  • Artigo

O método GetMyRoles recupera as funções de AC (autoridade de certificação ) do chamador.

Sintaxe

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Parâmetros

[in] strConfig

Valor de cadeia de caracteres que representa uma cadeia de caracteres de configuração válida para a AC no formato COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da AC, conforme inserido durante a instalação dos Serviços de Certificados. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

ImportanteGetMyRoles não limpa o cache interno quando a cadeia de caracteres de configuração é alterada. Ao alterar a cadeia de caracteres de configuração para a AC, você deve instanciar um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.
 

[out] pRoles

Um ponteiro para um valor LONG que representa as funções de AC recuperadas para o chamador. Isso pode ser uma combinação bit a bit de zero ou mais dos valores a seguir.

Valor Significado
CA_ACCESS_ADMIN
0x1
 O chamador tem a funcionalidade de administrador de AC.
CA_ACCESS_AUDITOR
0x4
 O chamador tem a capacidade de auditor da AC.
CA_ACCESS_ENROLL
0x200
 O chamador tem acesso de registro.
CA_ACCESS_OFFICER
0x2
 O chamador tem capacidade de oficial de autoridade de certificação.
CA_ACCESS_OPERATOR
0x8
 O chamador tem a funcionalidade de backup da AC.
CA_ACCESS_READ
0x100
 O chamador tem acesso de leitura da AC.

Valor retornado

C++

Se a função for bem-sucedida, o valor retornado será S_OK.

Se a função falhar, o valor retornado será um HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um valor Long que representa as funções de AC recuperadas para o chamador. Isso pode ser uma combinação bit a bit de zero ou mais dos valores a seguir.
Valor/código retornado Descrição
CA_ACCESS_ADMIN
0x1
 O chamador tem a funcionalidade de administrador de AC.
CA_ACCESS_AUDITOR
0x4
 O chamador tem a capacidade de auditor da AC.
CA_ACCESS_ENROLL
0x200
 O chamador tem acesso de registro.
CA_ACCESS_OFFICER
0x2
 O chamador tem capacidade de oficial de autoridade de certificação.
CA_ACCESS_OPERATOR
0x8
 O chamador tem a funcionalidade de backup da AC.
CA_ACCESS_READ
0x100
 O chamador tem acesso de leitura.

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certadm.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certadm.dll

Confira também

ICertAdmin2