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

こちらもご覧ください

OID サポート関数