Compartir a través de

IX509ExtensionBasicConstraints::InitializeEncode (certenroll.h)

  • Artículo

El método InitializeEncode inicializa la extensión a partir de un valor booleano que indica si el firmante del certificado es una entidad de certificación (CA) y un entero que contiene la profundidad de la cadena de ca subordinada.

Sintaxis

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

Parámetros

[in] IsCA

Variable VARIANT_BOOL que especifica si el firmante del certificado es una ENTIDAD de certificación.

[in] PathLenConstraint

Variable LONG que contiene el número máximo de certificados de la cadena.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

El método asocia la colección de nombres con el identificador de objeto (OID) de XCN_OID_BASIC_CONSTRAINTS2 (2.5.29.19) y lo codifica mediante reglas de codificación distinguida (DER).

Debe llamar a InitializeEncode o InitializeDecode para poder usar un objeto IX509ExtensionBasicConstraints . Los dos métodos se complementan entre sí. El método InitializeEncode permite construir un objeto de extensión notación de sintaxis abstracta con codificación DER (ASN.1) a partir de datos sin procesar y el método InitializeDecode permite inicializar los datos sin procesar desde un objeto codificado.

Puede recuperar las siguientes propiedades para esta extensión:

  • La propiedad Critical identifica si la extensión es crítica. También puede especificar esta propiedad.
  • La propiedad ObjectId recupera el OID.
  • La propiedad IsCA identifica si el firmante del certificado puede ser una entidad de certificación.
  • La propiedad PathLenConstraint identifica la profundidad de la cadena de entidad de certificación subordinada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IX509ExtensionBasicConstraints