Freigeben über

enrollCommon

Der Ordner "enrollmentCommon" enthält die folgenden Hilfsfunktionen und Makros, die von den Beispielen verwendet werden, die mit dem Zertifikatregistrierungs-SDK bereitgestellt werden. Sie ist standardmäßig im Ordner "%ProgramFiles%\Microsoft SDKs\Windows\v7.0\Samples\Security\X509 Certificate Enrollment\VC\enrollmentCommon" installiert.

Funktion Beschreibung
_JumpIfError Makro, das einen HRESULT--Wert, eine Bezeichnung und eine Fehlerzeichenfolge akzeptiert, die Zeichenfolge druckt und die Programmsteuerung an die erste Anweisung nach der Bezeichnung überträgt.
_JumpError Identisch mit dem _JumpIfError-Makro.
_PrintIfError Zurzeit nicht verwendet.
_PrintError Makro, das eine Fehlermeldung und einen HRESULT--Wert ausgibt.
convertWszToSz Konvertiert eine Zeichenfolge mit breitem Zeichen in eine ASCII-Zeichenfolge mithilfe der WideCharToMultiByte--Funktion und dem aktuellen ANSI-Codeseitenbezeichner für das System. Diese Funktion wird von den funktionen decConvertFromUnicode und findOIDFromTemplateName verwendet, die in enrollCommon.cpp definiert sind.
convertSzToWsz Konvertiert eine ASCII-Zeichenfolge in eine breite Zeichenfolge mithilfe der MultiByteToWideChar--Funktion und dem aktuellen ANSI-Codeseitenbezeichner für das System. Diese Funktion wird von der in enrollCommon.cpp definierten findCertByTemplate-Funktion verwendet.
convertSzToBstr Konvertiert eine ASCII-Zeichenfolge in eine BSTR- mithilfe der funktion MultiByteToWideChar. Diese Funktion wird derzeit nicht verwendet.
convertWszToBstr Wandelt eine breite Zeichenfolge in eine BSTR-um. Diese Funktion wird vom installResponseFromPFX-Beispiel verwendet.
checkEnrollStatus Überprüft den Status des Zertifikatregistrierungsprozesses mithilfe der IX509Enrollment und IX509EnrollmentStatus Schnittstellen. Diese Funktion wird von "enrollEOBOCMC", "enrollPKCS7", "enrollRenewalPKCS7", "enrollSimpleMachineCert" und "enrollSimpleUserCert"-Beispielen verwendet.
findCertByKeyUsage Listet den persönlichen Zertifikatspeicher des aktuellen Benutzers auf, um das erste Zertifikat zu finden, für das die beabsichtigte Verwendung des öffentlichen Schlüssels mit einem angegebenen Wert übereinstimmt. Der angegebene Wert kann eine bitweise Kombination der folgenden Flags sein:
  • 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
Diese Funktion wird vom beispiel "enrollFromPublicKey" verwendet.
findCertByEKU Listet den persönlichen Zertifikatspeicher des aktuellen Benutzers auf, um das erste Zertifikat zu finden, für das die Erweiterte Schlüsselverwendungserweiterung (Enhanced Key Usage, EKU) mit dem für die Eingabe angegebenen Übereinstimmend übereinstimmt. Weitere Informationen zur EKU-Erweiterung finden Sie in der IX509ExtensionEnhancedKeyUsage Schnittstelle. Diese Funktion wird vom Beispiel "enrollEOBOCMC" verwendet.
findCertByTemplate Listet den persönlichen Zertifikatspeicher des aktuellen Benutzers auf, um das erste Zertifikat zu finden, für das die Vorlage mit dem angegebenen Namen für die Eingabe übereinstimmt. Diese Funktion wird von den Samples "enrollPKCS7" und "enrollRenewalPKCS7" verwendet.
enrollCertByTemplate Initialisiert ein IX509Enrollment- -Objekt mithilfe einer Vorlage, versucht, die implizit erstellte Zertifikatanforderung zu registrieren und überwacht den Status des Registrierungsprozesses. Diese Funktion wird von "enrollEOBOCMC", "enrollFromPublicKey", "enrollPKCS7" und "enrollRenewalPKCS7" verwendet.
verifyCertContext Überprüft die Einhaltung der Zertifikatkette mit der angegebenen (Basis)-Richtlinie und optional mit einer angegebenen EKU-Erweiterung (Enhanced Key Usage). Weitere Informationen finden Sie in der funktion CertVerifyCertificateChainPolicy und den strukturen CERT_CHAIN_POLICY_PARA und CERT_CHAIN_PARA. Diese Funktion wird von "enrollEOBOCMC", "enrollFromPublicKey", "enrollPKCS7" und "enrollRenewalPKCS7" verwendet.
decConvertFromUnicode Konvertiert eine Zeichenfolge mit Unicode-Zeichen mit Doppelbyte in eine Zeichenfolge mit anSI-Zeichen mit einem Byte. Diese Funktion wird von der in enrollCommon.cpp definierten DecodeFileW-Funktion verwendet.
DecodeFileW Decodiert eine codierte Zertifikat- oder Zertifikatanforderungsdatei in ein Bytearray. Diese Funktion wird vom installResponseFromPFX-Beispiel verwendet.
EncodeToFileW Codiert ein Zertifikat oder eine Zertifikatanforderung und speichert es in einer Datei. Diese Funktion wird von den Beispielen createCNGCustomCMC, enrollEOBOCMC und enrollFromPublicKey verwendet.
findOIDFromTemplateName Ruft den Objektbezeichner für eine durch den Namen angegebene Vorlage ab. Diese Funktion wird von der in enrollCommon.cpp definierten findCertByTemplate-Funktion verwendet.

Verwenden der enthaltenen Beispiele

  • Last updated on