CryptGetDefaultOIDFunctionAddress 函式 (wincrypt.h)

CryptGetDefaultOIDFunctionAddress 函式會載入包含預設函式位址的 DLL。 它也可以傳回初始化函式集中第一個或下一個已安裝之預設 物件標識碼 (OID) 函式的位址，並載入包含該函式位址的 DLL。

語法

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

參數

[in] hFuncSet

先前從 CryptInitOIDFunctionSet 呼叫取得的函式集句柄。

[in] dwEncodingType

要比對的編碼類型。 目前只會使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;不過，未來可能會新增其他編碼類型。 若要比對目前的編碼類型，請使用：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

[in, optional] pwszDll

要載入之 DLL 的名稱。 一般而言，DLL 名稱是從 CryptGetDefaultOIDDllList 所傳回的清單取得。 如果 pwszDll 為 NULL，則會在已安裝的預設函式清單中執行搜尋。

[in] dwFlags

保留供日後使用，且必須為零。

[out] ppvFuncAddr

傳回函式位址的指標。 如果函式失敗，則會在 ppvFuncAddr 中傳回 NULL。

[in, out] phFuncAddr

只有在 pwszDll 為 NULL 時才使用。 在第一次呼叫函式時，*phFuncAddr 必須是 NULL ，才能取得第一個已安裝的函式。

當此函式成功時，*phFuncAddr 會設定為函式句柄。 函式句柄的 參考計數 會遞增。

在第一次呼叫函式之後， phFuncAddr 會設定為前一個呼叫所傳回的指標。 此輸入指標一律會透過呼叫 CryptFreeOIDFunctionAddress 在此函式內釋放。 即使main函式傳回錯誤，仍一律會呼叫釋放指標。

非 NULLphFuncAddr 必須透過對 CryptFreeOIDFunctionAddress 的呼叫來釋放，或藉由以輸入傳回給此函式或 CryptGetOIDFunctionAddress 的輸入來釋放。

如果 pwszDll 不是 NULL，則會忽略此參數的值，而且不會釋放非 NULL 指標。

傳回值

如果函式成功，函式會傳回非零 (TRUE) 。

如果函式失敗，它會傳回零 (FALSE) 。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	wincrypt.h
程式庫	Crypt32.lib
Dll	Crypt32.dll

另請參閱

OID 支援函式