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

pTargetName 매개 변수로 지정된 서버에서 사용자를 인증하는 데 사용할 수 있는 인증서의 인증서 체인을 지정하는 CERT_CHAIN_CONTEXT 구조 배열에 대한 포인터의 주소입니다.

반환 값

함수가 성공하면 STATUS_SUCCESS 반환합니다.

함수가 실패하면 실패한 이유를 나타내는 NTSTATUS 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certpoleng.h
라이브러리	Certpoleng.lib
DLL	Certpoleng.dll