ホーム › Security.Cryptography › NCryptIsAlgSupportedFn

NCryptIsAlgSupportedFn

コールバック

シグネチャ

HRESULT NCryptIsAlgSupportedFn(
    NCRYPT_PROV_HANDLE hProvider,
    LPWSTR pszAlgId,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

hProvider

NCRYPT_PROV_HANDLE

キーストレージプロバイダーのハンドルです。このハンドルは NCryptOpenStorageProvider 関数で取得します。

pszAlgId

LPWSTR

対象の暗号アルゴリズムを識別する、null で終わる Unicode 文字列へのポインターです。標準の CNG アルゴリズム識別子のいずれか、または登録された別のアルゴリズムの識別子を指定できます。

dwFlags

DWORD

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

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

公式ドキュメント

NCryptIsAlgSupported 関数は、CNG キーストレージプロバイダーが特定の暗号アルゴリズムをサポートしているかどうかを判定します。

戻り値

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

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

戻り値	説明
ERROR_SUCCESS	プロバイダーは指定されたアルゴリズムをサポートしています。
NTE_BAD_FLAGS	dwFlags パラメーターに、サポートされていないフラグが 1 つ以上含まれています。
NTE_INVALID_HANDLE	hProvider パラメーターで指定されたハンドルが無効です。
NTE_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
NTE_NOT_SUPPORTED	プロバイダーは指定されたアルゴリズムをサポートしていません。

解説(Remarks)

プロバイダーがそのアルゴリズムをサポートしている場合、この関数は ERROR_SUCCESS を返します。プロバイダーがそのアルゴリズムをサポートしておらず、他のエラーも発生していない場合、この関数は NTE_NOT_SUPPORTED を返します。

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

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