IEnumCERTVIEWCOLUMN::GetDisplayName-Methode (certview.h)

Artikel
08/22/2023

Die GetDisplayName-Methode ruft den lokalisierten Namen der aktuellen Spalte in der Spaltenaufzählungssequenz ab.

Syntax

HRESULT GetDisplayName(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Ein Zeiger auf eine Variable des BSTR-Typs , die den lokalisierten Namen der Spalte enthält.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der pstrOut-Parameter enthält den lokalisierten Namen der Spalte.

Um diese Methode zu verwenden, erstellen Sie eine Variable vom Typ BSTR , legen Sie die Variable gleich NULL fest, und übergeben Sie die Adresse dieser Variablen als pstrOut. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist eine Zeichenfolge , die den lokalisierten Namen der Spalte enthält.

Hinweise

Diese Methode wird verwendet, um den lokalisierten Namen der Spalte abzurufen, auf die derzeit von der Spaltenaufzählungssequenz verwiesen wird.

Wenn die Spaltenaufzählungssequenz nicht auf eine gültige Spalte verweist, schlägt GetDisplayName fehl. Verwenden Sie eine der folgenden Methoden, um durch die Enumeration zu navigieren:

IEnumCERTVIEWCOLUMN::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
IEnumCERTVIEWCOLUMN::Next: Wechselt zur nächsten Spalte in der Enumerationssequenz.
IEnumCERTVIEWCOLUMN::Skip: Überspringt eine angegebene Anzahl von Spalten.

Beispiele

BSTR     bstrDisplay = NULL;
HRESULT  hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrDisplay);

// Done processing, clear resources.
if (NULL != bstrDisplay)
    SysFreeString(bstrDisplay);

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certview.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll