Partager via

enrollCommon

  • Article

Le dossier enrollCommon contient les fonctions d’assistance et les macros suivantes utilisées par les exemples fournis avec le KIT de développement logiciel (SDK) d’inscription de certificat. Il est installé par défaut dans le dossier %ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 Certificate Enrollment\VC\enrollmentCommon.

Fonction Description
_JumpIfError La macro qui accepte une valeur HRESULT , une étiquette et une chaîne d’erreur, imprime la chaîne et transfère le contrôle de programme vers la première instruction qui suit l’étiquette.
_JumpError Identique à la macro _JumpIfError.
_PrintIfError Pas utilisé pour l'instant.
_PrintError Macro qui imprime un message d’erreur et une valeur HRESULT .
convertWszToSz Convertit une chaîne de caractères larges en chaîne de caractères ASCII à l’aide de la fonction WideCharToMultiByte et de l’identificateur de page de code ANSI actuel pour le système. Cette fonction est utilisée par les fonctions decConvertFromUnicode et findOIDFromTemplateName définies dans enrollCommon.cpp.
convertSzToWsz Convertit une chaîne ASCII en chaîne à caractères larges à l’aide de la fonction MultiByteToWideChar et de l’identificateur de page de code ANSI actuel pour le système. Cette fonction est utilisée par la fonction findCertByTemplate définie dans enrollCommon.cpp.
convertSzToBstr Convertit une chaîne ASCII en BSTR à l’aide de la fonction MultiByteToWideChar . Cette fonction n’est pas utilisée actuellement.
convertWszToBstr Convertit une chaîne à caractères larges en BSTR. Cette fonction est utilisée par l’exemple installResponseFromPFX.
checkEnrollStatus Vérifie la status du processus d’inscription de certificat à l’aide des interfaces IX509Enrollment et IX509EnrollmentStatus. Cette fonction est utilisée par les exemples enrollEOBOCMC, enrollPKCS7, enrollRenewalPKCS7, enrollSimpleMachineCert et enrollSimpleUserCert.
findCertByKeyUsage Énumère le magasin de certificats personnel de l’utilisateur actuel pour trouver le premier certificat pour lequel l’utilisation prévue de la clé publique correspond à une valeur spécifiée. La valeur spécifiée peut être une combinaison au niveau du bit des indicateurs suivants :
  • 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
Cette fonction est utilisée par l’exemple enrollFromPublicKey.
findCertByEKU Énumère le magasin de certificats personnel de l’utilisateur actuel pour trouver le premier certificat pour lequel l’extension EKU (Enhanced Key Usage) correspond à celui spécifié lors de l’entrée. Pour plus d’informations sur l’extension EKU, consultez l’interface IX509ExtensionEnhancedKeyUsage . Cette fonction est utilisée par l’exemple enrollEOBOCMC.
findCertByTemplate Énumère le magasin de certificats personnel de l’utilisateur actuel pour rechercher le premier certificat pour lequel le modèle correspond à celui spécifié, par nom, en entrée. Cette fonction est utilisée par les exemples enrollPKCS7 et enrollRenewalPKCS7.
inscrireCertByTemplate Initialise un objet IX509Enrollment à l’aide d’un modèle, tente d’inscrire la demande de certificat créée implicitement et surveille la status du processus d’inscription. Cette fonction est utilisée par les exemples enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 et enrollRenewalPKCS7.
verifyCertContext Vérifie la conformité de la chaîne de certificats à la stratégie (de base) spécifiée et, éventuellement, à une extension eKU (Enhanced Key Usage) spécifiée. Pour plus d’informations, consultez la fonction CertVerifyCertificateChainPolicy et les structures CERT_CHAIN_POLICY_PARA et CERT_CHAIN_PARA . Cette fonction est utilisée par les exemples enrollEOBOCMC, enrollFromPublicKey, enrollPKCS7 et enrollRenewalPKCS7.
decConvertFromUnicode Convertit une chaîne de caractères Unicode sur deux octets en une chaîne de caractères ANSI sur un octet. Cette fonction est utilisée par la fonction DecodeFileW définie dans enrollCommon.cpp.
DecodeFileW Décode un fichier de demande de certificat ou de certificat encodé dans un tableau d’octets. Cette fonction est utilisée par l’exemple installResponseFromPFX.
EncodeToFileW Encode un certificat ou une demande de certificat et l’enregistre dans un fichier. Cette fonction est utilisée par les exemples createCNGCustomCMC, enrollEOBOCMC et enrollFromPublicKey.
findOIDFromTemplateName Récupère l’identificateur d’objet d’un modèle spécifié par nom. Cette fonction est utilisée par la fonction findCertByTemplate définie dans enrollCommon.cpp.

Utilisation des exemples inclus