IEnumCERTVIEWATTRIBUTE::GetName 方法 (certview.h)
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 |