Método IPolicyQualifier::InitializeEncode (certenroll.h)

  • Artículo

El método InitializeEncode inicializa el objeto de una cadena y un valor que identifica el tipo de calificador.

Sintaxis

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

Parámetros

[in] strQualifier

Variable BSTR que contiene el calificador.

[in] Type

Valor de enumeración PolicyQualifierType que especifica el tipo de calificador aplicado a una directiva de certificado. Puede ser uno de los siguientes valores.

Valor Significado
PolicyQualifierTypeUnknown
 No se especifica el tipo de calificador.
PolicyQualifierTypeUrl
 El calificador es una dirección URL que apunta a una declaración de práctica de certificación (CPS) definida por la entidad de certificación para describir las directivas con las que se emitió el certificado y los propósitos para los que se puede usar el certificado.
PolicyQualifierTypeUserNotice
 El calificador es una instrucción de texto que la aplicación mostrará a cualquier usuario que se base en el certificado. El aviso del usuario identifica los usos permitidos del certificado.

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 devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

Si especifica PolicyQualifierTypeUrl en el parámetro Type, este método asocia la cadena especificada en el parámetro strQualifier con el XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) identificador de objeto (OID) y lo codifica mediante reglas de codificación distinguida (DER). La dirección URL se codifica como una cadena IA5 de notación de sintaxis abstracta ( ASN.1).

Si especifica PolicyQualifierTypeUserNotice en el parámetro Type , este método asocia la cadena especificada en el parámetro strQualifier con el XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) y lo codifica mediante DER.

Puede recuperar las siguientes propiedades para este objeto:

  • La propiedad ObjectId recupera un OID que identifica si el calificador es un CPS o un aviso de usuario.
  • La propiedad Qualifier recupera la cadena especificada para el parámetro strQualifier del método InitializeEncode .
  • La propiedad RawData recupera el calificador codificado por DER.
  • La propiedad Type recupera un valor de la enumeración PolicyQualifierType que especifica el tipo de calificador.

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

IPolicyQualifier