ICertPropertyFriendlyName::Initialize-Methode (certenroll.h)

Die Initialize-Methode initialisiert das -Objekt aus dem Anzeigenamen des Zertifikats. Diese Methode ist webfähig.

Syntax

HRESULT Initialize(
  [in] BSTR strFriendlyName
);

Parameter

[in] strFriendlyName

Eine BSTR-Variable , die den Namen enthält. Die Länge der Zeichenfolge darf 260 Zeichen nicht überschreiten.

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.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)	Die Zeichenfolgenlänge überschreitet 260 Zeichen.

Hinweise

In der Regel geben Sie den Anzeigenamen in einer Benutzeroberfläche oder über die Befehlszeile an, bevor sie mit dem Registrierungsprozess beginnen, damit der Name dem Dummyzertifikat im Anforderungsspeicher zugeordnet werden kann. Um diesen Wert abzurufen und hier zu verwenden, rufen Sie certificateFriendlyName auf der IX509Enrollment-Schnittstelle auf .

Rufen Sie die SetValueOnCertificate-Methode auf, um die Eigenschaft einem Zertifikat zuzuordnen. Rufen Sie die FriendlyName-Eigenschaft auf, um den Anzeigenamen 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

ICertProperties

ICertProperty

ICertPropertyDescription

ICertPropertyFriendlyName