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 :
|
| 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. |