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

  • Artículo

El método GetMyRoles recupera los roles de entidad de certificación (CA) del autor de la llamada.

Sintaxis

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

Parámetros

[in] strConfig

Valor de cadena que representa una cadena de configuración válida para la ENTIDAD de certificación con el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor de Servicios de certificados y CANAME es el nombre común de la ENTIDAD de certificación, tal como se escribió durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

ImportanteGetMyRoles no borra la memoria caché interna cuando se cambia la cadena de configuración. Al cambiar la cadena de configuración de la ENTIDAD de certificación, debe crear una instancia de un nuevo objeto ICertAdmin y llamar a este método de nuevo con la nueva cadena de configuración.
 

[out] pRoles

Puntero a un valor LONG que representa los roles de CA recuperados para el autor de la llamada. Puede ser una combinación bit a bit de cero o más de los valores siguientes.

Valor Significado
CA_ACCESS_ADMIN
0x1
 El autor de la llamada tiene la funcionalidad de administrador de CA.
CA_ACCESS_AUDITOR
0x4
 El autor de la llamada tiene capacidad de auditor de CA.
CA_ACCESS_ENROLL
0x200
 El autor de la llamada tiene acceso a la inscripción.
CA_ACCESS_OFFICER
0x2
 El autor de la llamada tiene la funcionalidad del oficial de ca.
CA_ACCESS_OPERATOR
0x8
 El autor de la llamada tiene la funcionalidad de copia de seguridad de ca.
CA_ACCESS_READ
0x100
 El autor de la llamada tiene acceso de lectura de CA.

Valor devuelto

C++

Si la función se ejecuta correctamente, el valor devuelto se S_OK.

Si se produce un error en la función, el valor devuelto es un VALOR HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es un valor long que representa los roles de CA recuperados para el autor de la llamada. Puede ser una combinación bit a bit de cero o más de los valores siguientes.
Código o valor devuelto Descripción
CA_ACCESS_ADMIN
0x1
 El autor de la llamada tiene la funcionalidad de administrador de CA.
CA_ACCESS_AUDITOR
0x4
 El autor de la llamada tiene capacidad de auditor de CA.
CA_ACCESS_ENROLL
0x200
 El autor de la llamada tiene acceso a la inscripción.
CA_ACCESS_OFFICER
0x2
 El autor de la llamada tiene la funcionalidad del oficial de ca.
CA_ACCESS_OPERATOR
0x8
 El autor de la llamada tiene la funcionalidad de copia de seguridad de ca.
CA_ACCESS_READ
0x100
 El autor de la llamada tiene acceso de lectura.

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certadm.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

ICertAdmin2