IEnumCERTVIEWATTRIBUTE：：GetName 方法 (certview.h)

發行項
02/26/2024

GetName 方法會擷取屬性列舉序列中目前屬性的名稱。

語法

HRESULT GetName(
  [out] BSTR *pstrOut
);

參數

[out] pstrOut

包含屬性名稱之 BSTR 型別變數的指標。

傳回值

C++

如果方法成功，方法會傳回S_OK，而 pstrOut 參數包含屬性的名稱。

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

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

VB

傳回值是 String ，其中包含屬性的名稱。

備註

這個方法可用來擷取屬性列舉序列目前參考的屬性名稱。

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

IEnumCERTVIEWATTRIBUTE：：Reset：移至列舉序列的開頭。
IEnumCERTVIEWATTRIBUTE：：Next：移至列舉序列中的下一個屬性。
IEnumCERTVIEWATTRIBUTE：：Skip：略過指定的屬性數目。

範例

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

規格需求

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