CngKey.Open Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Paket:

System.Security.Cryptography.Cng v5.0.0

Var olan bir anahtarı temsil eden bir CngKey nesne örneği oluşturur.

Aşırı Yüklemeler

Open(String)	Mevcut adlandırılmış anahtarı temsil eden bir CngKey nesnenin örneğini oluşturur.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Var olan bir CngKey anahtara tanıtıcı kullanarak nesnenin bir örneğini oluşturur.
Open(String, CngProvider)	Belirtilen anahtar depolama sağlayıcısını CngKey (KSP) kullanarak mevcut adlandırılmış anahtarı temsil eden bir nesne örneği oluşturur.
Open(String, CngProvider, CngKeyOpenOptions)	Belirtilen anahtar depolama sağlayıcısını (KSP) ve anahtar açma seçeneklerini kullanarak mevcut adlandırılmış anahtarı temsil eden bir nesne örneği CngKey oluşturur.

Open(String)

Kaynak:

Cng.NotSupported.cs

Mevcut adlandırılmış anahtarı temsil eden bir CngKey nesnenin örneğini oluşturur.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open (string keyName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String) As CngKey

Parametreler

keyName

String

Anahtarın adı.

Döndürülenler

CngKey

Mevcut bir anahtar.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

keyName, null değeridir.

PlatformNotSupportedException

Şifreleme Yeni Nesil (CNG) bu sistemde desteklenmiyor.

CryptographicException

Diğer tüm hatalar.

Açıklamalar

Bu aşırı yükleme aşağıdaki varsayılanları kullanır:

• Anahtar depolama sağlayıcısı (KSP): MicrosoftSoftwareKeyStorageProvider. Open(String, CngProvider) Başka bir KSP belirtmek istiyorsanız aşırı yüklemeyi kullanın.

• Anahtar açma seçenekleri: CngKeyOpenOptions.None.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Kaynak:

Cng.NotSupported.cs

Var olan bir CngKey anahtara tanıtıcı kullanarak nesnenin bir örneğini oluşturur.

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.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyHandle As SafeNCryptKeyHandle, keyHandleOpenOptions As CngKeyHandleOpenOptions) As CngKey

Parametreler

keyHandle

SafeNCryptKeyHandle

Mevcut bir anahtarın tanıtıcısı.

keyHandleOpenOptions

CngKeyHandleOpenOptions

Kısa ömürlü anahtarı mı yoksa adlandırılmış anahtarı mı keyHandle temsil ettiğini gösteren numaralandırma değerlerinden biri.

Döndürülenler

CngKey

Mevcut bir anahtar.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

keyHandle, null değeridir.

ArgumentException

keyHandle geçersiz veya hatalı biçimlendirilmiş veya zaten kapalı. Bu özel durum, anahtar ortak dil çalışma zamanı (CLR) tarafından oluşturulan kısa ömürlü bir anahtarsa da oluşturulur, ancak EphemeralKey değer belirtilmez.

PlatformNotSupportedException

Şifreleme Yeni Nesil (CNG) bu sistemde desteklenmiyor.

CryptographicException

Diğer tüm hatalar.

Açıklamalar

Bu aşırı yükleme, gelişmiş kullanıcıların platform çağrısına veya C++'ın yönetilen birlikte çalışma özelliğine bağlı olsalar bile CNG sınıflarını kullanmasına olanak tanır. Örneğin, anahtarı NCRYPT_KEY_HANDLE olarak döndüren yerel bir kitaplığınız varsa, bu aşırı yükleme anahtarın etrafında yönetilen bir sarmalayıcı oluşturmanıza ve CNG sınıflarını kullanarak onu işlemenize olanak tanır.

Bir anahtarı tutamacını kullanarak açtığınızda, anahtarın kısa ömürlü durumunu belirleyemezsiniz ve kendiniz belirtmeniz gerekir. sınıfının çeşitli özellikleri CngKey doğru olması için bu değeri kullanır. Bu nedenle, yöntemlere doğru bayrak değerini geçirdiğinizden Open emin olun.

Open(String, CngProvider)

Kaynak:

Cng.NotSupported.cs

Belirtilen anahtar depolama sağlayıcısını CngKey (KSP) kullanarak mevcut adlandırılmış anahtarı temsil eden bir nesne örneği oluşturur.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider) As CngKey

Parametreler

keyName

String

Anahtarın adı.

provider

CngProvider

Anahtarı içeren KSP.

Döndürülenler

CngKey

Mevcut bir anahtar.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

keyName veya provider şeklindedir null.

PlatformNotSupportedException

Şifreleme Yeni Nesil (CNG) bu sistemde desteklenmiyor.

CryptographicException

Diğer tüm hatalar.

Açıklamalar

Yöntem aşırı yüklemesinin Open(String) aksine, bu aşırı yükleme sağlayıcıyı belirtmenize olanak tanır. Buna ek olarak, varsayılan CngKeyOpenOptions değeri None oluşturulur ve anahtara bağlanır.

Open(String, CngProvider, CngKeyOpenOptions)

Kaynak:

Cng.NotSupported.cs

Belirtilen anahtar depolama sağlayıcısını (KSP) ve anahtar açma seçeneklerini kullanarak mevcut adlandırılmış anahtarı temsil eden bir nesne örneği CngKey oluşturur.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::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.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider, openOptions As CngKeyOpenOptions) As CngKey

Parametreler

keyName

String

Anahtarın adı.

provider

CngProvider

Anahtarı içeren KSP.

openOptions

CngKeyOpenOptions

Anahtarın nereden açıldığı (makine veya kullanıcı depolaması) ve kullanıcı arabirimi isteminin gizlenip gizlenmeyeceği gibi, anahtarı açma seçeneklerini belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

Döndürülenler

CngKey

Mevcut bir anahtar.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

keyName veya provider şeklindedir null.

PlatformNotSupportedException

Şifreleme Yeni Nesil (CNG) bu sistemde desteklenmiyor.

CryptographicException

Diğer tüm hatalar.

Açıklamalar

Yöntem aşırı yüklemesinin Open(String) aksine, bu aşırı yükleme hem sağlayıcıyı hem de anahtar açma seçeneklerini belirtmenize olanak tanır.