ICertPropertyEnrollment::Initialize-Methode (certenroll.h)

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
);

Die Parameter

[in] RequestId

Eine LONG-Variable , die die Zertifikatanforderungs-ID enthält. Eine Anforderungs-ID wird vom Registrierungsprozess 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 CADnsName\CAName-Konfigurationszeichenfolge . 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 die Bestandteile getrennt wird.

[in] strCAName

Eine BSTR-Variable , die den allgemeinen Antragstellernamen (CN) der Zertifizierungsstelle enthält. Dies ist der zweite Name in der CADnsName\CAName-Konfigurationszeichenfolge . 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 Registrierungsvorgangs 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

Die Werte, die Sie zum Initialisieren des ICertPropertyEnrollment-Objekts verwenden können, werden während des Zertifikatregistrierungsprozesses festgelegt, wenn der Client die Enrollment-Methode für das IX509Enrollment-Objekt aufruft. Rufen Sie zum Abrufen einer Anforderungs-ID die RequestId-Eigenschaft für das IX509Enrollment-Objekt auf. Rufen Sie zum Abrufen eines Zertifikatanzeigenamens die Eigenschaft "CertificateFriendlyName " auf. Rufen Sie die CAConfigString-Eigenschaft auf, und trennen Sie die Konfigurationszeichenfolge in ihre Bestandteile, um einen distinguished name und common name abzurufen.

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:

• CADnsName
• CAName
• FriendlyName
• RequestId

Anforderungen

Siehe auch

ICertProperty-

ICertPropertyEnrollment