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

Artigo
08/22/2023

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

Compartilhar via