ICertView::OpenView 方法 (certview.h)

OpenView 方法打开证书服务数据库的视图,并实例化 IEnumCERTVIEWROW 对象的实例。

语法

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

参数

[out] ppenum

指向 IEnumCERTVIEWROW 类型的指针的指针。

返回值

C++

如果该方法成功,该方法将返回S_OK。

如果方法失败,它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

VB

返回值为 IEnumCERTVIEWROW 对象。

注解

在调用 OpenView 方法之前,必须首先通过调用 OpenConnection 方法与证书服务服务器建立连接。

此调用返回的 IEnumCERTVIEWROW 对象表示行枚举序列,其内部索引指向序列的开头。 若要查看序列中的第一行,请调用
IEnumCERTVIEWROW::Next 方法,将内部索引移到第一行。

若要查看非默认列集或行的子集,请在调用 OpenConnection 之后和调用 OpenView 之前调用 SetResultColumnCountSetResultColumnSetRestriction

示例

// 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

另请参阅

ICertView

ICertView2

ICertView::OpenConnection

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next