CngKey.Open Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

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 nesne örneği 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ı (KSP) kullanarak mevcut adlandırılmış anahtarı temsil eden bir CngKey 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 CngKey nesne örneği oluşturur.

Open(String)

Kaynak:

Cng.NotSupported.cs

Mevcut adlandırılmış anahtarı temsil eden bir CngKey nesne örneği 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.

• Tuş 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

Var olan 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ı kullanmalarına olanak tanır. Örneğin, anahtarı NCRYPT_KEY_HANDLE olarak döndüren bir yerel 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 anahtarı 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 CngKey çeşitli özellikleri doğru olması için bu değere güvenir. 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ı (KSP) kullanarak mevcut adlandırılmış anahtarı temsil eden bir CngKey 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. Ayrıca, varsayılan CngKeyOpenOptions değeri None oluşturulur ve anahtarına bağlıdı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 CngKey nesne örneği 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ığını (makine veya kullanıcı depolaması) ve kullanıcı arabirimi isteminin engellenip 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.