Edit

WintrustLoadFunctionPointers function (wintrust.h)

  • Article

[The WintrustLoadFunctionPointers function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. For certificate verification, use the CertGetCertificateChain and CertVerifyCertificateChainPolicy functions. For Microsoft Authenticode technology signature verification, use the .NET Framework.]

The WintrustLoadFunctionPointers function loads function entry points for a specified action GUID. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll.

Syntax

BOOL WintrustLoadFunctionPointers(
  [in]  GUID                     *pgActionID,
  [out] CRYPT_PROVIDER_FUNCTIONS *pPfns
);

Parameters

[in] pgActionID

A pointer to a GUID structure that identifies the action whose function pointers are being loaded and the trust provider that supports that action.

The WinTrust service is designed to work with trust providers implemented by third parties. Each trust provider provides its own unique set of action identifiers. For information about the action identifiers supported by a trust provider, see the documentation for that trust provider.

For example, Microsoft provides a Software Publisher Trust Provider that can establish the trustworthiness of software being downloaded from the Internet or some other public network. The Software Publisher Trust Provider supports the following action identifiers. These constants are defined in Softpub.h.

Value Meaning
WINTRUST_ACTION_GENERIC_VERIFY
 Verify a certificate chain only.
WINTRUST_ACTION_GENERIC_VERIFY_V2
 Verify a file or object using the Authenticode policy provider.
HTTPSPROV_ACTION
 Verify an SSL/PCT connection through Internet Explorer.

[out] pPfns

A pointer to the CRYPT_PROVIDER_FUNCTIONS structure that receives the addresses of the function pointers.

Return value

The return value is TRUE if the function succeeds; FALSE if the function fails.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header wintrust.h
Library Wintrust.lib
DLL Wintrust.dll