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

Artículo
03/14/2023

El método GetCAProperty recupera un valor de propiedad para la entidad de certificación (CA). La funcionalidad de este método es idéntica a ICertAdmin2::GetCAProperty. Para obtener información sobre este método, vea ICertAdmin2::GetCAProperty.

Sintaxis

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

Parámetros

[in] strConfig

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 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.

[in] PropIndex

Si PropId se indexa, el índice de base cero que se va a usar al recuperar el valor de la propiedad. Si PropId no está indexado, se omite este valor.

[in] PropType

Especifica el tipo de la propiedad , que corresponde a la columna Type de la tabla PropId . El tipo puede ser uno de los siguientes tipos.

Valor	Significado
PROPTYPE_LONG	Datos largos firmados
PROPTYPE_DATE	Fecha y hora (reservada para uso futuro)
PROPTYPE_BINARY	Datos binarios
PROPTYPE_STRING	Datos de cadena Unicode

[in] Flags

Se pueden usar las marcas siguientes para especificar el formato del valor de propiedad devuelto; estas marcas solo tienen significado para los datos binarios (como certificados, cadenas de certificados o listas de revocación de certificados) y se omiten en caso contrario.

Valor	Significado
CV_OUT_BASE64	BASE64 sin BEGIN/END
CV_OUT_BASE64HEADER	BASE64 con BEGIN CERTIFICATE y END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 con BEGIN NEW CERTIFICATE REQUEST y END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 con BEGIN X509 CRL y END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Cadena hexadecimal
CV_OUT_HEXADDR	Cadena hexadecimal con dirección/desplazamiento
CV_OUT_HEXASCII	Cadena hexadecimal con ASCII
CV_OUT_HEXASCIIADDR	Cadena hexadecimal con ASCII y dirección/desplazamiento

[out, retval] pvarPropertyValue

Puntero a un variant que recibe el valor de propiedad solicitado.

Cuando haya terminado de usar variant, libere la llamada a la función VariantClear .

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 un valor Variant que recibe el valor de propiedad solicitado.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
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

Consulte también

CCertRequest

ICertRequest

ICertRequest2

Compartir a través de