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 |