IEnumCERTVIEWATTRIBUTE::GetName-Methode (certview.h)
Die GetName-Methode ruft den Namen des aktuellen Attributs in der Attributenumerationssequenz ab.
Syntax
HRESULT GetName(
[out] BSTR *pstrOut
);
Parameter
[out] pstrOut
Ein Zeiger auf eine Variable vom BSTR-Typ , die den Namen des Attributs 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 des Attributs.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 des Attributs enthält.Hinweise
Diese Methode wird verwendet, um den Namen des Attributs abzurufen, auf das derzeit von der Attributenumerationssequenz verwiesen wird.
Wenn die Attributenumerationssequenz nicht auf ein gültiges Attribut verweist, schlägt GetName fehl. Verwenden Sie eine der folgenden Methoden, um durch die Enumeration zu navigieren:
- IEnumCERTVIEWATTRIBUTE::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
- IEnumCERTVIEWATTRIBUTE::Next: Wechselt zum nächsten Attribut in der Enumerationssequenz.
- IEnumCERTVIEWATTRIBUTE::Skip: Überspringt eine angegebene Anzahl von Attributen.
Beispiele
BSTR bstrAttribName = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
printf("Failed call to GetName - %x\n", hr);
else
printf("Attribute name is %ws\n", bstrAttribName );
// free memory when done
if (NULL != bstrAttribName)
SysFreeString(bstrAttribName);
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 |