Поделиться через

Функция 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
Header certpoleng.h
Библиотека Certpoleng.lib
DLL Certpoleng.dll