WintrustGetDefaultForUsage 函数 (wintrust.h)

  • 项目

WintrustGetDefaultForUsage 函数检索默认的使用标识符和回调信息。

语法

BOOL WintrustGetDefaultForUsage(
  [in]      DWORD                   dwAction,
  [in]      const char              *pszUsageOID,
  [in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);

参数

[in] dwAction

要执行的操作。 这可以是以下值之一。 有关详细信息，请参阅“备注”。

值 含义
DWACTION_ALLOCANDFILL
 分配内存并填充 psUsage 参数指向的CRYPT_PROVIDER_DEFUSAGE结构。
DWACTION_FREE
 通过为此参数指定 DWACTION_ALLOCANDFILL 释放在上一次调用此函数期间分配的所有内存。

[in] pszUsageOID

指向包含标识符的字符串的指针。

[in, out] psUsage

指向包含要检索的回调信息的 CRYPT_PROVIDER_DEFUSAGE 结构的指针。

返回值

如果函数成功，则返回值为 TRUE ;如果函数失败，则 为 FALSE 。 如果函数失败，请调用 GetLastError 函数来确定失败原因。

注解

将 dwAction 参数设置为 DWACTION_ALLOCANDFILL 调用此函数一次，以分配内存并使用信息填充 CRYPT_PROVIDER_DEFUSAGE 结构。 再次调用此函数，并将 dwAction 参数设置为 DWACTION_FREE 以释放分配的内存。

提供程序的默认使用情况和回调信息通过调用 WintrustAddDefaultForUsage 函数进行注册。

要求

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

另请参阅

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage