Функция WintrustGetDefaultForUsage (wintrust.h)

  • Статья

Функция WintrustGetDefaultForUsage извлекает идентификатор использования по умолчанию и сведения о обратном вызове.

Синтаксис

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

Параметры

[in] dwAction

Выполняемая операция. Это может быть одно из следующих значений. Дополнительные сведения см. в подразделе "Примечания".

Значение Значение
DWACTION_ALLOCANDFILL
 Выделите память и заполните структуру CRYPT_PROVIDER_DEFUSAGE , на которую указывает параметр psUsage .
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
Header wintrust.h
Библиотека Wintrust.lib
DLL Wintrust.dll

См. также раздел

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage