IEnumCERTVIEWCOLUMN::GetName-Methode (certview.h)

Artikel
02/26/2024

Die GetName-Methode ruft den nicht lokalisierten Namen der aktuellen Spalte in der Spaltenenumerationssequenz ab.

Syntax

HRESULT GetName(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Ein Zeiger auf eine Variable vom BSTR-Typ , die den 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 Namen der Spalte.

Um diese Methode zu verwenden, erstellen Sie eine Variable vom Typ BSTR , legen Sie die Variable auf 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 Namen der Spalte enthält.

Hinweise

Diese Methode wird verwendet, um den nicht lokalisierten Namen der Spalte abzurufen, auf die derzeit von der Spaltenenumerationssequenz verwiesen wird.

Wenn die Spaltenenumerationssequenz nicht auf eine gültige Spalte verweist, schlägt GetName 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       bstrColName = NULL;
HRESULT    hr;

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

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

Anforderungen

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