enrollCommon

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 certificats. il est installé par défaut dans le dossier % ProgramFiles% \ Microsoft sdk \ Windows \ v 7.0 \ samples \ Security \ X509 certificate \ \ enrollCommon.

Fonction Description
_JumpIfError Macro qui accepte une valeur HRESULT , une étiquette et une chaîne d’erreur, imprime la chaîne et transfère le contrôle du programme à 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 une chaîne de caractères ASCII à l’aide de la fonction WideCharToMultiByte et de l’identificateur de page de codes ANSI actuel du 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 une chaîne de caractères larges à l’aide de la fonction MultiByteToWideChar et de l’identificateur de page de codes ANSI actuel du 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 de caractères larges en BSTR. Cette fonction est utilisée par l’exemple installResponseFromPFX.
checkEnrollStatus Vérifie l’état du processus d’inscription de certificats à 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 personnels de l’utilisateur actuel pour rechercher 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 personnels de l’utilisateur actuel pour rechercher le premier certificat pour lequel l’extension d’utilisation améliorée de la clé correspond à celle spécifiée en entrée. Pour plus d’informations sur l’extension d’utilisation améliorée de la carte, consultez l’interface IX509ExtensionEnhancedKeyUsage . Cette fonction est utilisée par l’exemple enrollEOBOCMC.
findCertByTemplate Énumère le magasin de certificats personnels 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.
enrollCertByTemplate Initialise un objet IX509Enrollment à l’aide d’un modèle, tente d’inscrire la demande de certificat créée implicitement et surveille l’état 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 par rapport à la stratégie (de base) spécifiée et, éventuellement, à l’extension d’utilisation améliorée de la clé 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 codés 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 certificat encodé ou un fichier de demande de certificat en 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 pour 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