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

  • Artículo

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