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

  • Artigo

O método GetMyRoles obtém a máscara de acesso de funções de privilégio para um usuário em um determinado servidor respondente do Protocolo de Status de Certificado Online (OCSP).

Sintaxe

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

Parâmetros

[in] bstrServerName

Uma cadeia de caracteres que contém o nome do respondente-servidor.

[out] pRoles

Um ponteiro para a máscara de acesso de 32 bits.

Retornar valor

C++

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

A máscara de acesso de 32 bits.

Comentários

O servidor respondente OCSP define as máscaras a seguir para funções de privilégio de acesso.

Constante Valor do C++ Valor do Script VB Descrição
CA_ACCESS_ADMIN 0x001 &H1 Administrador de AC
CA_ACCESS_READ 0x100 &H100 Acesso somente leitura a uma AC
CA_ACCESS_ENROLL 0x200 &H200 Registrar acesso a uma AC
 

Exemplos de privilégios que um usuário pode ter, dependendo da máscara:

  • Configurar e atualizar um servidor OCSP.
  • Atribua o certificado e a chave de assinatura existentes.
  • Instalar e atualizar crls (Listas de revogação de certificado).
  • Configure um formato de resposta.

Requisitos

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

Confira também

IOCSPAdmin