次の方法で共有

CryptSetProviderW 関数 (wincrypt.h)

  • [アーティクル]
重要 この API は非推奨です。 新規および既存のソフトウェアでは、Cryptography Next Generation API の使用を開始する必要があります。 Microsoft は、今後のリリースでこの API を削除する可能性があります。
 
CryptSetProvider 関数は、現在のユーザーの既定の 暗号化サービス プロバイダー (CSP) を指定します。

現在のユーザーの既定のプロバイダーが設定されている場合、その既定のプロバイダーは、CSP 名ではなく、dwProvType プロバイダーの種類を指定、そのユーザーが CryptAcquireContext を する任意の呼び出しによって取得されます。

この関数の拡張バージョンである CryptSetProviderExも利用できます。

一般的なアプリケーション この関数は使用されません。 これは、管理アプリケーションでのみ使用することを目的としています。
 

構文

BOOL CryptSetProviderW(
  [in] LPCWSTR pszProvName,
  [in] DWORD   dwProvType
);

パラメーター

[in] pszProvName

新しい既定の CSP の名前。 名前付き CSP がコンピューターにインストールされている必要があります。 使用可能な暗号化プロバイダーの一覧については、「暗号化プロバイダー名の」を参照してください。

[in] dwProvType

pszProvNameで指定 CSP のプロバイダーの種類。

戻り値

関数が成功した場合、戻り値は 0 以外 (TRUE) です。

関数が失敗した場合、戻り値は 0 (FALSE) です。 拡張エラー情報については、GetLastError呼び出します。 考えられるエラー コードを次の表に示します。

リターン コード 形容
ERROR_INVALID_HANDLE
 パラメーターの 1 つは無効なハンドルを指定します。
ERROR_INVALID_PARAMETER
 パラメーターの 1 つに無効な値が含まれています。 これは、多くの場合、無効なポインターです。
ERROR_NOT_ENOUGH_MEMORY
 操作中にオペレーティング システムのメモリが不足しました。
 

エラーは、内部呼び出しから RegCreateKeyEx への伝達と RegSetValueExすることもできます。

備考

一般的なアプリケーションでは、CryptAcquireContext呼び出すときに CSP 名を指定しません。ただし、アプリケーションには特定の CSP を選択するオプションがあります。 これにより、ユーザーは適切なレベルのセキュリティを備えた CSP を自由に選択できます。

CryptSetProvider を呼び出すと、その時点から実行されるすべてのアプリケーションで使用される指定された型の CSP が決定されるため、ユーザーの同意なしにこの関数を呼び出してはなりません。

手記

wincrypt.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CryptSetProvider を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wincrypt.h
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

CryptAcquireContext

暗号化プロバイダー名

RegCreateKeyEx の

RegSetValueEx を する

サービス プロバイダー関数の