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 |
|---|---|
|
Das Objekt ist bereits initialisiert. |
|
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 |