CngKey.Open メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
既存のキーを表す CngKey オブジェクトのインスタンスを作成します。
オーバーロード
| Open(String) |
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを作成します。 |
| Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions) |
既存のキーを識別するハンドルを使用して、CngKey オブジェクトのインスタンスを作成します。 |
| Open(String, CngProvider) |
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを、指定した KSP を使用して作成します。 |
| Open(String, CngProvider, CngKeyOpenOptions) |
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを、指定した KSP およびキーを開くオプションを使用して作成します。 |
Open(String)
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを作成します。
public:
static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);public static System.Security.Cryptography.CngKey Open (string keyName);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName);static member Open : string -> System.Security.Cryptography.CngKey[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyName As String) As CngKeyパラメーター
- keyName
- String
キーの名前です。
戻り値
既存のキー。
- 属性
例外
keyName が nullです。
Cryptography Next Generation (CNG) は、このシステムではサポートされていません。
上記以外のすべてのエラー。
注釈
このオーバーロードでは、次の既定値が使用されます。
キー ストレージ プロバイダー (KSP): MicrosoftSoftwareKeyStorageProvider。 別の KSP を Open(String, CngProvider) 指定する場合は、 オーバーロードを使用します。
キーを開くオプション: CngKeyOpenOptions.None。
適用対象
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)
既存のキーを識別するハンドルを使用して、CngKey オブジェクトのインスタンスを作成します。
public:
static System::Security::Cryptography::CngKey ^ Open(Microsoft::Win32::SafeHandles::SafeNCryptKeyHandle ^ keyHandle, System::Security::Cryptography::CngKeyHandleOpenOptions keyHandleOpenOptions);public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);[System.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open (Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey[<System.Security.SecurityCritical>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyHandle As SafeNCryptKeyHandle, keyHandleOpenOptions As CngKeyHandleOpenOptions) As CngKeyパラメーター
- keyHandle
- SafeNCryptKeyHandle
既存のキーを識別するハンドル。
- keyHandleOpenOptions
- CngKeyHandleOpenOptions
keyHandle が短期キーを表しているのか、名前付きキーを表しているのかを示す列挙値の 1 つ。
戻り値
既存のキー。
- 属性
例外
keyHandle が nullです。
keyHandle が無効か、形式が正しくないか、または既に閉じられています。 この例外は、キーが CLR で作成された短期キーであり、EphemeralKey 値が指定されていない場合にもスローされます。
Cryptography Next Generation (CNG) は、このシステムではサポートされていません。
上記以外のすべてのエラー。
注釈
このオーバーロードにより、高度なユーザーは、プラットフォーム呼び出しまたは C++ のマネージド相互運用機能に依存している場合でも、CNG クラスを使用できます。 たとえば、NCRYPT_KEY_HANDLEとしてキーを返すネイティブ ライブラリがある場合、このオーバーロードを使用すると、キーの周りにマネージド ラッパーを作成し、CNG クラスを使用して操作できます。
そのハンドルを使用してキーを開くと、キーのエフェメラル状態を特定できず、自分で指定する必要があります。 クラスのいくつかのプロパティは、 CngKey この値を正しく使用します。 そのため、正しいフラグ値をメソッドに Open 渡してください。
適用対象
Open(String, CngProvider)
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを、指定した KSP を使用して作成します。
public:
static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider);public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider);static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyName As String, provider As CngProvider) As CngKeyパラメーター
- keyName
- String
キーの名前です。
- provider
- CngProvider
キーを格納する KSP。
戻り値
既存のキー。
- 属性
例外
keyName または provider が null です。
Cryptography Next Generation (CNG) は、このシステムではサポートされていません。
上記以外のすべてのエラー。
注釈
メソッド の Open(String) オーバーロードとは異なり、このオーバーロードではプロバイダーを指定できます。 さらに、 のNone既定値CngKeyOpenOptionsが作成され、キーにバインドされます。
適用対象
Open(String, CngProvider, CngKeyOpenOptions)
既存の名前付きキーを表す CngKey オブジェクトのインスタンスを、指定した KSP およびキーを開くオプションを使用して作成します。
public:
static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider, System::Security::Cryptography::CngKeyOpenOptions openOptions);public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);[System.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey[<System.Security.SecurityCritical>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyName As String, provider As CngProvider, openOptions As CngKeyOpenOptions) As CngKeyパラメーター
- keyName
- String
キーの名前です。
- provider
- CngProvider
キーを格納する KSP。
- openOptions
- CngKeyOpenOptions
キーを (コンピューターまたはユーザーの記憶域) から開く場所や UI のプロンプトを抑制するかどうかなど、キーを開くためのオプションを指定する列挙値のビットごとの組み合わせ。
戻り値
既存のキー。
- 属性
例外
keyName または provider が null です。
Cryptography Next Generation (CNG) は、このシステムではサポートされていません。
上記以外のすべてのエラー。
注釈
メソッド の Open(String) オーバーロードとは異なり、このオーバーロードを使用すると、プロバイダーとキーオープン オプションの両方を指定できます。
適用対象
.NET