CngKey.Open Yöntem

Başvuru

Tanım

Ad Alanı:: System.Security.Cryptography

Bütünleştirilmiş Kod:: System.Security.Cryptography.Cng.dll

Bütünleştirilmiş Kod:: System.Security.Cryptography.dll

Bütünleştirilmiş Kod:: System.Core.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Security.Cryptography.Cng.dll

Paket:: System.Security.Cryptography.Cng v5.0.0

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Kaynak:: Cng.NotSupported.cs

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);

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.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.

Şunlara uygulanır

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Kaynak:: Cng.NotSupported.cs

Kaynak:: Cng.NotSupported.cs

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);

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.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 SecurityCriticalAttribute

Ö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.

Şunlara uygulanır

Open(String, CngProvider)

Kaynak:: Cng.NotSupported.cs

Kaynak:: Cng.NotSupported.cs

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);

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.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.

Şunlara uygulanır

Open(String, CngProvider, CngKeyOpenOptions)

Kaynak:: Cng.NotSupported.cs

Kaynak:: Cng.NotSupported.cs

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);

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.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 SecurityCriticalAttribute

Ö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.

Şunlara uygulanır

Aracılığıyla paylaş

CngKey.Open Yöntem

Tanım

Aşırı Yüklemeler

Open(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Open(String, CngProvider)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Open(String, CngProvider, CngKeyOpenOptions)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar