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
程式庫 Wintrust.lib
Dll Wintrust.dll

另請參閱

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage