ホーム › Security.Cryptography › NCryptOpenStorageProviderFn

NCryptOpenStorageProviderFn

コールバック

シグネチャ

HRESULT NCryptOpenStorageProviderFn(
    NCRYPT_PROV_HANDLE* phProvider,
    LPWSTR pszProviderName,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

phProvider

NCRYPT_PROV_HANDLE*

プロバイダーのハンドルを受け取る NCRYPT_PROV_HANDLE 変数へのポインターです。このハンドルの使用を終えたら、NCryptFreeObject 関数に渡して解放してください。

pszProviderName

LPWSTR

読み込むキーストレージプロバイダーを識別する、null で終わる Unicode 文字列へのポインターです。これは、キーストレージプロバイダーの登録されたエイリアスです。このパラメーターは省略可能で、NULL を指定できます。このパラメーターが NULL の場合は、既定のキーストレージプロバイダーが読み込まれます。次の値は、組み込みのキーストレージプロバイダーを識別します。

値	意味
MS_KEY_STORAGE_PROVIDER L"Microsoft Software Key Storage Provider"	Microsoft が提供するソフトウェアキーストレージプロバイダーを識別します。
MS_SMART_CARD_KEY_STORAGE_PROVIDER L"Microsoft Smart Card Key Storage Provider"	Microsoft が提供するスマートカードキーストレージプロバイダーを識別します。
MS_PLATFORM_CRYPTO_PROVIDER L"Microsoft Platform Crypto Provider"	Microsoft が提供する TPM キーストレージプロバイダーを識別します。

dwFlags

DWORD

関数の動作を変更するフラグです。この関数に対して定義されているフラグはありません。

公式ドキュメント

NCryptOpenStorageProvider 関数は、CNG キーストレージプロバイダーを読み込んで初期化します。

戻り値

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

戻り値のコードには、次のようなものがあります (これらに限定されません)。

戻り値のコード	説明
ERROR_SUCCESS	関数は成功しました。
NTE_BAD_FLAGS	dwFlags パラメーターに、サポートされていないフラグが 1 つ以上含まれています。
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)