IEnumCERTVIEWCOLUMN：：GetName 方法 (certview.h)

發行項
02/23/2024

GetName 方法會擷取數據行列舉序列中目前數據行的非配置名稱。

語法

HRESULT GetName(
  [out] BSTR *pstrOut
);

參數

[out] pstrOut

包含資料行名稱之 BSTR 類型的變數指標。

傳回值

C++

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

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

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

VB

傳回值是包含數據行名稱的 String 。

備註

這個方法可用來擷取數據行列舉序列目前所參考之數據行的非配置名稱。

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

IEnumCERTVIEWCOLUMN：：Reset：移至列舉序列的開頭。
IEnumCERTVIEWCOLUMN：：Next：移至列舉序列中的下一個數據行。
IEnumCERTVIEWCOLUMN：：Skip：略過指定的數據行數目。

範例

BSTR       bstrColName = NULL;
HRESULT    hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrColName);

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

規格需求

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