ICertView：：OpenView 方法 (certview.h)

發行項
08/22/2023

OpenView方法會開啟憑證服務資料庫的檢視，並具現化IEnumCERTVIEWROW物件的實例。

語法

HRESULT OpenView(
  [out] IEnumCERTVIEWROW **ppenum
);

參數

[out] ppenum

IEnumCERTVIEWROW類型的指標。

傳回值

C++

如果方法成功，方法會傳回S_OK。

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

VB

傳回值是 IEnumCERTVIEWROW 物件。

備註

呼叫 OpenView 方法之前，必須先呼叫 OpenConnection 方法，以建立與憑證服務伺服器的連線。

這個呼叫所傳回的 IEnumCERTVIEWROW 物件代表資料列列舉序列，其內部索引指向序列的開頭。若要查看序列中的第一個資料列，請呼叫
IEnumCERTVIEWROW：：Next 方法，可將內部索引移至第一個資料列。

若要檢視非預設資料行集或資料列的子集，請在呼叫OpenConnection和呼叫OpenView之前呼叫SetResultColumnCount、SetResultColumn和SetRestriction。

範例

// pCertView is previously instantiated pointer to ICertView.
IEnumCERTVIEWROW * pEnumRow = NULL;
HRESULT    hr;

hr = pCertView->OpenView(&pEnumRow);
if (S_OK != hr)
    printf("Failed ICertView::OpenView - %x\n", hr);
else
    // use pEnumRow as needed, to enumerate data rows
    // ...
// Done processing, free resources.
if (NULL != pEnumRow)
    pEnumRow->Release();

規格需求


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