通过

PstGetCertificates 函数 (certpoleng.h)

  • 项目

检索指定可用于对指定服务器上的用户进行身份验证的证书的证书链。

语法

NTSTATUS PstGetCertificates(
  [in]           PUNICODE_STRING        pTargetName,
  [in]           DWORD                  cCriteria,
  [in, optional] PCCERT_SELECT_CRITERIA rgpCriteria,
  [in]           BOOL                   bIsClient,
  [out]          PDWORD                 pdwCertChainContextCount,
  [out]          PCCERT_CHAIN_CONTEXT   **ppCertChainContexts
);

参数

[in] pTargetName

要检查的服务器的名称。

[in] cCriteria

rgpCriteria 数组中的元素数。

[in, optional] rgpCriteria

指向 CERT_SELECT_CRITERIA 结构的数组的常量指针，这些结构指定用于选择证书链的条件。

[in] bIsClient

如果调用方是客户端，则为 TRUE;否则为 FALSE。

[out] pdwCertChainContextCount

ppCertChainContexts 数组中的元素数。

[out] ppCertChainContexts

指向 CERT_CHAIN_CONTEXT 结构的数组的指针的地址，该结构指定证书链，这些证书链可用于在 pTargetName 参数指定的服务器上对用户进行身份验证。

返回值

如果函数成功，则返回 STATUS_SUCCESS。

如果函数失败，则返回一个 NTSTATUS 代码，指示它失败的原因。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 certpoleng.h
Library Certpoleng.lib
DLL Certpoleng.dll