Share via

NCryptOpenStorageProvider 関数 (ncrypt.h)

  • [アーティクル]

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

構文

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

パラメーター

[out] phProvider

プロバイダー ハンドルを受け取る NCRYPT_PROV_HANDLE 変数へのポインター。 このハンドルの使用が完了したら、 NCryptFreeObject 関数に渡して解放します。

[in, optional] pszProviderName

読み込むキー ストレージ プロバイダーを識別する 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 キー ストレージ プロバイダーを識別します。

[in] dwFlags

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

戻り値

関数の成功または失敗を示す状態コードを返します。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード 説明
ERROR_SUCCESS
 関数は成功しました。
NTE_BAD_FLAGS
 dwFlags パラメーターには、サポートされていない 1 つ以上のフラグが含まれています。
NTE_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
NTE_NO_MEMORY
 メモリ割り当てエラーが発生しました。

注釈

エラー条件が返された場合、プロバイダーはメモリからアンロードされます。 エラー エラーが返された後、プロバイダー内の関数を呼び出してはなりません。

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー ncrypt.h
Library Ncrypt.lib
[DLL] Ncrypt.dll