PstGetTrustAnchors function (certpoleng.h)

Retrieves a list of certification authorities (CAs) trusted by the specified server.

Syntax

NTSTATUS PstGetTrustAnchors(
  [in]           PUNICODE_STRING                 pTargetName,
  [in]           DWORD                           cCriteria,
  [in, optional] PCCERT_SELECT_CRITERIA          rgpCriteria,
  [out]          PSecPkgContext_IssuerListInfoEx *ppTrustedIssuers
);

Parameters

[in] pTargetName

The name of the server to check.

[in] cCriteria

The number of elements in the rgpCriteria array.

[in, optional] rgpCriteria

A constant pointer to an array of CERT_SELECT_CRITERIA structures that specify the criteria used to select certificate chains.

[out] ppTrustedIssuers

A pointer to an array of SecPkgContext_IssuerListInfoEx structures that receive the CAs trusted by the server specified by the pTargetName parameter.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Requirements