Método ICertRequest2::GetCAPropertyDisplayName (certcli.h)

Artículo
02/26/2024

El método GetCAPropertyDisplayName recupera el nombre para mostrar de la propiedad para una propiedad de entidad de certificación (CA).

Sintaxis

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

Parámetros

[in] strConfig

Representa una cadena de configuración válida para la ENTIDAD de certificación con el formato NombreDeEquipo\, donde NombreDeEquipo 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 especifica durante la configuración de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

[in] PropId

Especifica el identificador de propiedad. Para obtener información sobre este parámetro, vea la tabla en ICertAdmin2::GetCAProperty.

[out, retval] pstrDisplayName

Puntero al BSTR que representa el nombre para mostrar de la propiedad. Cuando haya terminado de usar BSTR, ábrelo llamando a la función SysFreeString .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve 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 una cadena que contiene el nombre para mostrar de la propiedad.

Comentarios

La funcionalidad del método GetCAPropertyDisplayName es similar a la del método ICertAdmin2::GetCAPropertyDisplayName .

En el método ICertAdmin2, la ENTIDAD de certificación exige que el autor de la llamada tenga acceso de lectura de CA, que normalmente solo se concede a los oficiales de ca y a los administradores de ca.

Por el contrario, en las implementaciones ICertRequest2 e ICertRequest3 del método , la ENTIDAD de certificación no requiere ningún derecho de acceso de forma predeterminada. Solo se aplican listas de control de acceso (ACL) del Modelo de objetos componentes distribuidos (DCOM); para una ENTIDAD de certificación unida a un dominio, las ACL de DCOM permiten que todos accedan a las CA. Todos no incluyen Anónimo. La interfaz de solicitud de la entidad de certificación se puede bloquear mediante la configuración del Registro para exigir que el autor de la llamada tenga acceso de inscripción.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certcli.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll