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 auflisten. Diese Methode ist webfähig.

Syntax

HRESULT Initialize(
  [in] BSTR strDescription
);

Parameter

[in] strDescription

Eine BSTR-Variable , die eine Beschreibung 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, gibt sie einen HRESULT-Wert zurück, 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

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