IEnumCERTVIEWEXTENSION：：GetName 方法 (certview.h)

發行項
02/23/2024

GetName 方法會擷取延伸模組列舉序列中目前延伸模組的名稱。

傳回的延伸模組名稱是 OID) 字串 (物件識別符，如 L“2.5.29.31”

語法

HRESULT GetName(
  [out] BSTR *pstrOut
);

參數

[out] pstrOut

包含延伸模組名稱之 BSTR 型別值的指標。

傳回值

C++

如果方法成功，方法會傳回S_OK，並將 pstrOut 參數設定為延伸模組的名稱。

若要使用此方法，請建立 BSTR 類型的變數、將變數設定為 NULL，並將此變數的位址傳遞為 pstrOut。當您完成 使用 BSTR 時，請藉由呼叫 SysFreeString 函式來釋放它。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

VB

傳回值是包含延伸模組名稱的 String 。

備註

此函式用來擷取延伸模組列舉序列目前參考的延伸模組名稱。

如果延伸模組列舉序列未參考有效的延伸模組， GetName 將會失敗。使用下列其中一種方法來巡覽列舉：

IEnumCERTVIEWEXTENSION：：Reset：移至列舉序列中的下一個延伸模組。
IEnumCERTVIEWEXTENSION：：Next：移至列舉序列中的下一個延伸模組。
IEnumCERTVIEWEXTENSION：：Skip：略過指定的延伸模組數目。

範例

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);

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll