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 Zeichenfolgenlänge darf 260 Zeichen nicht überschreiten.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OKzurü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.
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
Das Objekt wurde bereits initialisiert. |
|
Die Zeichenfolgenlänge überschreitet 260 Zeichen. |
Bemerkungen
In der Regel geben Sie den Anzeigenamen in einer Benutzeroberfläche oder über die Befehlszeile an, bevor Sie den Registrierungsvorgang beginnen, damit der Name dem Dummyzertifikat im Anforderungsspeicher zugeordnet werden kann. Um diesen Wert abzurufen und hier zu verwenden, rufen Sie die 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | certenroll.h |
| DLL- | CertEnroll.dll |