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)
Library	Certidl.lib
DLL	Certadm.dll