Freigeben über


ICertPropertyDescription::Initialize-Methode (certenroll.h)

Die Initialize-Methode initialisiert das Objekt aus einer Zeichenfolge, die beschreibende Informationen zum Zertifikat enthält. Verwenden Sie diese Eigenschaft, um eine Zeichenfolge zu erstellen, die in Benutzeroberflächen angezeigt werden kann, die Zertifikateigenschaften aufzählen. Diese Methode ist webfähig.

Syntax

HRESULT Initialize(
  [in] BSTR strDescription
);

Die Parameter

[in] strDescription

Eine BSTR-Variable , die eine Beschreibung enthält. Die Zeichenfolgenlänge 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ö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 Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
Das Objekt wurde bereits initialisiert.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
Die Zeichenfolgenlänge überschreitet 260 Zeichen.

Bemerkungen

Rufen Sie die SetValueOnCertificate-Methode auf, um die Eigenschaft einem Zertifikat zuzuordnen. Rufen Sie die Description-Eigenschaft auf, um die Beschreibungszeichenfolge abzurufen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h
DLL CertEnroll.dll

Siehe auch

ICertProperties-

ICertProperty-

ICertPropertyDescription-

ICertPropertyFriendlyName