Compartir a través de

enrollCommon

  • Artículo

La carpeta enrollCommon contiene las siguientes funciones auxiliares y macros usadas por los ejemplos proporcionados con el SDK de inscripción de certificados. Se instala de forma predeterminada en la carpeta %ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 Certificate Enrollment\VC\enrollCommon.

Función Descripción
_JumpIfError Macro que acepta un valor HRESULT , una etiqueta y una cadena de error, imprime la cadena y transfiere el control de programa a la primera instrucción después de la etiqueta.
_JumpError Igual que la macro _JumpIfError.
_PrintIfError No se usa actualmente.
_PrintError Macro que imprime un mensaje de error y un valor HRESULT .
convertWszToSz Convierte una cadena de caracteres anchos en una cadena de caracteres ASCII mediante la función WideCharToMultiByte y el identificador de página de códigos ANSI actual para el sistema. Esta función la usan las funciones decConvertFromUnicode y findOIDFromTemplateName definidas en enrollCommon.cpp.
convertSzToWsz Convierte una cadena ASCII en una cadena de caracteres anchos mediante la función MultiByteToWideChar y el identificador de página de códigos ANSI actual para el sistema. Esta función la usa la función findCertByTemplate definida en enrollCommon.cpp.
convertSzToBstr Convierte una cadena ASCII en un BSTR mediante la función MultiByteToWideChar . Esta función no se usa actualmente.
convertWszToBstr Convierte una cadena de caracteres anchos en un BSTR. El ejemplo installResponseFromPFX usa esta función.
checkEnrollStatus Comprueba el estado del proceso de inscripción de certificados mediante las interfaces IX509Enrollment y IX509EnrollmentStatus . Esta función la usan los ejemplos enrollEOBOCMC, enrollPKCS7, enrollRenewalPKCS7, enrollSimpleMachineCert e enrollSimpleUserCert.
findCertByKeyUsage Enumera el almacén de certificados personal del usuario actual para buscar el primer certificado para el que el uso previsto de la clave pública coincide con un valor especificado. El valor especificado puede ser una combinación bit a bit de las marcas siguientes:
  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_KEY_AGREEMENT_KEY_USAGE
  • CERT_KEY_CERT_SIGN_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE
  • CERT_OFFLINE_CRL_SIGN_KEY_USAGE
El ejemplo enrollFromPublicKey usa esta función.
findCertByEKU Enumera el almacén de certificados personal del usuario actual para buscar el primer certificado para el que la extensión Uso mejorado de claves (EKU) coincide con la especificada en la entrada. Para obtener más información sobre la extensión EKU, consulte la interfaz IX509ExtensionEnhancedKeyUsage . El ejemplo enrollEOBOCMC usa esta función.
findCertByTemplate Enumera el almacén de certificados personal del usuario actual para buscar el primer certificado para el que la plantilla coincide con la especificada, por nombre, en la entrada. Esta función la usan los ejemplos enrollPKCS7 e enrollRenewalPKCS7.
enrollCertByTemplate Inicializa un objeto IX509Enrollment mediante una plantilla, intenta inscribir la solicitud de certificado creada implícitamente y supervisa el estado del proceso de inscripción. Esta función la usan los ejemplos enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
verifyCertContext Comprueba el cumplimiento de la cadena de certificados con la directiva especificada (base) y, opcionalmente, en una extensión de uso mejorado de clave (EKU) especificada. Para obtener más información, consulte la función CertVerifyCertificateChainPolicy y las estructuras CERT_CHAIN_POLICY_PARA y CERT_CHAIN_PARA . Esta función la usan los ejemplos enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 e enrollRenewalPKCS7.
decConvertFromUnicode Convierte una cadena de caracteres Unicode de doble byte en una cadena de caracteres ANSI de un solo byte. Esta función la usa la función DecodeFileW definida en enrollCommon.cpp.
DecodeFileW Descodifica un certificado codificado o un archivo de solicitud de certificado en una matriz de bytes. El ejemplo installResponseFromPFX usa esta función.
EncodeToFileW Codifica un certificado o solicitud de certificado y lo guarda en un archivo. Esta función la usan los ejemplos createCNGCustomCMC, enrollEOBOCMC e enrollFromPublicKey.
findOIDFromTemplateName Recupera el identificador de objeto de una plantilla especificada por nombre. Esta función la usa la función findCertByTemplate definida en enrollCommon.cpp.

Uso de los ejemplos incluidos