CryptGetDefaultOIDDllList 関数 (wincrypt.h)

  • [アーティクル]

CryptGetDefaultOIDDllList 関数は、指定された関数セットとエンコード型に対して登録された既定のオブジェクト識別子 (OID) 関数を含む DLL ファイルの名前の一覧を取得します。

構文

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

パラメーター

[in] hFuncSet

CryptInitOIDFunctionSet の呼び出しによって以前に取得された関数セット ハンドル。

[in] dwEncodingType

照合するエンコードの種類を指定します。 現在、X509_ASN_ENCODINGとPKCS_7_ASN_ENCODINGのみが使用されています。ただし、今後、エンコードの種類が追加される可能性があります。 両方の現在のエンコードの種類と一致するには、次の値を使用します。

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

メモ 証明書または メッセージ エンコードの種類 が必要です。 X509_ASN_ENCODINGが既定値です。 その型が示されている場合は、 が使用されます。それ以外の場合は、PKCS7_ASN_ENCODING型が示されている場合は、それが使用されます。
 

[out] pwszDllList

0 個以上の null で終わるファイル名のリストを受け取るバッファーへのポインター。 返されたリストは、終端の NULL 文字で終了します。 たとえば、次の 2 つの名前の一覧を次に示します。

L"first.dll\0" L"second.dll\0" L"\0"

バッファーが保持する必要があるワイド文字の数を取得するには、このパラメーターを NULL にすることができます。 詳細については、「不明な 長さのデータの取得」を参照してください。

[in, out] pcchDllList

pwszDllList パラメーターが指す返されるリストのサイズをワイド文字で指定する DWORD へのポインター。 関数が戻るときに、 pcchDllList パラメーターが指す変数には、バッファーに格納されているワイド文字の数が含まれます。

メモ バッファーで返されたデータを処理する場合、アプリケーションは返されるデータの実際のサイズを使用する必要があります。 実際のサイズは、入力時に指定されたバッファーのサイズよりも若干小さくすることができます。 入力では、バッファー サイズは通常、バッファーに収まる最大の出力データを確保するのに十分な大きさで指定されます。 出力時に、このパラメーターが指す変数は、バッファーにコピーされたデータの実際のサイズを反映するように更新されます。
 

戻り値

関数が成功した場合、関数は 0 以外 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。 拡張エラー情報については、 GetLastError を呼び出します。

この関数には、次のエラー コードがあります。

リターン コード 説明
ERROR_MORE_DATA
 pwszDllList パラメーターで指定されたバッファーが、返されたデータを保持するのに十分な大きさでない場合、関数はERROR_MORE_DATAコードを設定し、必要なバッファー サイズをワイド文字で pcchDllList が指す変数に格納します。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincrypt.h
Library Crypt32.lib
[DLL] Crypt32.dll

関連項目

OID サポート関数