IEnumCERTVIEWEXTENSION::GetName-Methode (certview.h)

Artikel
02/26/2024

Die GetName-Methode ruft den Namen der aktuellen Erweiterung in der Extension-Enumeration-Sequenz ab.

Der zurückgegebene Erweiterungsname ist eine Objektbezeichnerzeichenfolge (Object Identifier, OID), wie in L"2.5.29.31".

Syntax

HRESULT GetName(
  [out] BSTR *pstrOut
);

Parameter

[out] pstrOut

Ein Zeiger auf einen Wert vom BSTR-Typ , der den Namen der Erweiterung enthält.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der pstrOut-Parameter ist auf den Namen der Erweiterung festgelegt.

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 Namen der Erweiterung enthält.

Hinweise

Diese Funktion wird verwendet, um den Namen der Erweiterung abzurufen, auf die derzeit von der Extension-Enumerationssequenz verwiesen wird.

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

IEnumCERTVIEWEXTENSION::Reset: Wechselt zur nächsten Erweiterung in der Enumerationssequenz.
IEnumCERTVIEWEXTENSION::Next: Wechselt zur nächsten Erweiterung in der Enumerationssequenz.
IEnumCERTVIEWEXTENSION::Skip: Überspringt eine angegebene Anzahl von Erweiterungen.

Beispiele

BSTR  bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
    printf("Extension name is: %ws\n", bstrExtName);
else
    printf("GetName failed: %x\n", hr);

// free memory when done
if (NULL != bstrExtName)
    SysFreeString(bstrExtName);

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