IEnumCERTVIEWEXTENSION：：GetName 方法 (certview.h)

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

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

語法

HRESULT GetName(
  [out] BSTR *pstrOut
);

參數

[out] pstrOut

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

傳回值

C++

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

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

VB

備註

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

如果延伸模組列舉序列未參考有效的延伸模組， 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);

規格需求

另請參閱

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION：：GetFlags

IEnumCERTVIEWEXTENSION：：GetValue

IEnumCERTVIEWEXTENSION：：Next

IEnumCERTVIEWEXTENSION：：Reset

IEnumCERTVIEWEXTENSION：：Skip