ホーム › Security.Cryptography › NCryptEnumStorageProvidersFn

NCryptEnumStorageProvidersFn

コールバック

シグネチャ

HRESULT NCryptEnumStorageProvidersFn(
    DWORD* pdwProviderCount,
    NCryptProviderName** ppProviderList,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

pdwProviderCount

DWORD*

ppProviderList 配列の要素数を受け取る DWORD のアドレスです。

ppProviderList

NCryptProviderName**

登録されているキーストレージプロバイダー名の配列を受け取る NCryptProviderName 構造体ポインターのアドレスです。pdwProviderCount パラメーターが指す変数は、この配列の要素数を受け取ります。

このメモリが不要になったら、このポインターを NCryptFreeBuffer 関数に渡して解放してください。

dwFlags

DWORD

関数の動作を変更するフラグです。ゼロ (0) または次の値を指定できます。

値	意味
NCRYPT_SILENT_FLAG	キーストレージプロバイダー (KSP) がユーザーインターフェイスを表示しないように要求します。プロバイダーが動作するために UI を表示する必要がある場合、この呼び出しは失敗し、KSP は最後のエラーとして NTE_SILENT_CONTEXT エラーコードを設定します。

公式ドキュメント

NCryptEnumStorageProviders 関数は、登録されているキーストレージプロバイダーの名前を取得します。

戻り値

関数の成功または失敗を示すステータスコードを返します。

返される可能性のあるコードには、次のものが含まれます (これらに限定されません)。

戻り値	説明
ERROR_SUCCESS	関数は成功しました。
NTE_BAD_FLAGS	dwFlags パラメーターに無効な値が含まれています。
NTE_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
NTE_NO_MEMORY	メモリの割り当てに失敗しました。

解説(Remarks)

サービスは、この関数を StartService 関数から呼び出してはなりません。サービスが StartService 関数からこの関数を呼び出すと、デッドロックが発生し、サービスが応答しなくなることがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)