ICertPropertyEnrollment::Initialize-Methode (certenroll.h)

Artikel
08/22/2023

Die Initialize-Methode initialisiert die Eigenschaft aus der Zertifikatanforderungs-ID, der Konfigurationszeichenfolge der Zertifizierungsstelle (CA) und einem optionalen Zertifikatanzeigenamen.

Syntax

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Parameter

[in] RequestId

Eine LONG-Variable , die die Zertifikatanforderungs-ID enthält. Durch den Registrierungsprozess wird eine Anforderungs-ID erstellt. Sie können diesen Wert abrufen, indem Sie die RequestId-Eigenschaft auf der IX509Enrollment-Schnittstelle aufrufen.

[in] strCADnsName

Eine BSTR-Variable , die den DNS-Namen (Domain Name System) der Zertifizierungsstelle enthält. Dies ist der Vorname in der Konfigurationszeichenfolge CADnsName\CAName . Die Konfigurationszeichenfolge wird in der Regel während des Registrierungsprozesses festgelegt. Der DNS-Name kann abgerufen werden, indem die CAConfigString-Eigenschaft aufgerufen und die Zeichenfolge in ihre Bestandteile getrennt wird.

[in] strCAName

Eine BSTR-Variable , die den allgemeinen Namen des Antragstellers (Common Name, CN) der Zertifizierungsstelle enthält. Dies ist der zweite Name in der Konfigurationszeichenfolge CADnsName\CAName . Die Konfigurationszeichenfolge wird in der Regel während des Registrierungsprozesses festgelegt. Der CN-Name kann abgerufen werden, indem die CAConfigString-Eigenschaft aufgerufen und die Zeichenfolge in ihre Bestandteile getrennt wird.

[in, optional] strFriendlyName

Eine BSTR-Variable , die einen optionalen Anzeigenamen für das Zertifikat enthält. Der Standardwert ist NULL. Dieser Wert wird in der Regel während des Registrierungsprozesses festgelegt. Sie können sie abrufen, indem Sie die CertificateFriendlyName-Eigenschaft aufrufen.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, 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/-wert	BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Die Werte, die Sie zum Initialisieren des ICertPropertyEnrollment-Objekts verwenden können, werden während des Zertifikatregistrierungsprozesses festgelegt, wenn der Client die Enroll-Methode für das IX509Enrollment-Objekt aufruft . Das heißt, um eine Anforderungs-ID abzurufen, rufen Sie die RequestId-Eigenschaft für das IX509Enrollment-Objekt auf. Rufen Sie die CertificateFriendlyName-Eigenschaft auf, um einen Zertifikatanzeigenamen abzurufen. Um einen distinguished Name und einen allgemeinen Namen abzurufen, rufen Sie die CAConfigString-Eigenschaft auf, und trennen Sie die Konfigurationszeichenfolge in ihre Bestandteile.

Rufen Sie die SetValueOnCertificate-Methode auf, um die Eigenschaft einem Zertifikat zuzuordnen. Sie können auch die folgenden Eigenschaften aufrufen, um die während der Initialisierung angegebenen Werte abzurufen:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

ICertProperty

ICertPropertyEnrollment

Freigeben über