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
将来使用するために予約されており、0 である必要があります。
[out] ppvFuncAddr
戻り関数のアドレスへのポインター。 関数が失敗した場合は、ppvFuncAddr で NULL が返されます。
[in, out] phFuncAddr
pwszDll が NULL の場合にのみ使用されます。 関数の最初の呼び出しで、最初にインストールされた関数を取得するには、*phFuncAddr を NULL にする 必要があります。
この関数が成功すると、*phFuncAddr は関数ハンドルに設定されます。 関数ハンドルの 参照カウント がインクリメントされます。
関数の最初の呼び出しの後、 phFuncAddr は前の呼び出しによって返されたポインターに設定されます。 この入力ポインターは、この関数による CryptFreeOIDFunctionAddress の呼び出しによって、関数内で常に解放されます。 ポインターを解放する呼び出しは、メイン関数がエラーを返した場合でも常に行われます。
NULL 以外の phFuncAddr は、CryptFreeOIDFunctionAddress の呼び出しを通じて、またはこの関数への入力として、または CryptGetOIDFunctionAddress への入力として渡すことによって解放する必要があります。
pwszDll が NULL でない場合、このパラメーターの値は無視され、NULL 以外のポインターは解放されません。
戻り値
関数が成功した場合、関数は 0 以外 (TRUE) を返します。
関数が失敗した場合は、0 (FALSE) を返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincrypt.h |
| Library | Crypt32.lib |
| [DLL] | Crypt32.dll |