IEnumCERTVIEWCOLUMN::GetName-Methode (certview.h)
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 |