IX509EnrollmentHelper::Enroll-Methode (certenroll.h)

Artikel
08/22/2023

Die Enroll-Methode registriert eine Zertifikatanforderung und ruft das ausgestellte Zertifikat ab. Diese Methode ist webfähig.

Syntax

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Parameter

[in] strEnrollmentPolicyServerURI

Ein BSTR , der die URL des Zertifikatregistrierungsrichtlinienservers enthält.

[in] strTemplateName

Eine BSTR-Variable , die den allgemeinen Namen (Common Name, CN) der Vorlage enthält, wie er in Active Directory angezeigt wird, oder den dezimalen Objektbezeichner mit Punkt.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Codierungstyp angibt, der zu Anzeigezwecken auf ein Bytearray angewendet wird.

[in] enrollFlags

Ein WebEnrollmentFlags-Enumerationswert , der das Verhalten der Webregistrierung angibt. Dies kann der folgende Wert sein.

Wert	Bedeutung
RegistrierenPrompt	Wenn dieses Flag festgelegt ist und keine Authentifizierungsanmeldeinformationen für den Zertifikatregistrierungsserver verfügbar sind, fordert der Zertifikatdienst zur Eingabe von Anmeldeinformationen auf. Wenn keine Anmeldeinformationen für die Authentifizierung vorhanden sind und dieses Flag nicht festgelegt ist, schlägt die Enroll-Methode fehl.

[out, retval] pstrCertificate

Ein BSTR , der das ausgestellte Zertifikat enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode	Beschreibung
E_INVALIDARG	Die Parameter strEnrollmentPolicyServerURI und strTemplateName dürfen nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)	Die Parameter strEnrollmentPolicyServerURI und strTemplateName überschreiten 64.000 Zeichen oder enthalten eingebettete NULL-Zeichen.

Hinweise

Die Enroll-Methode ruft die entsprechende Vorlage ab, ruft InitializeFromTemplate auf und ruft dann Enroll für das IX509Enrollment-Objekt auf.

Mit dieser Methode wird das ausgestellte Zertifikat nicht installiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

IX509EnrollmentHelper

Freigeben über