CngKey.Open Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una instancia de un CngKey objeto que representa una clave existente.
Sobrecargas
| Nombre | Description |
|---|---|
| Open(String) |
Crea una instancia de un CngKey objeto que representa una clave con nombre existente. |
| Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions) |
Crea una instancia de un CngKey objeto mediante un identificador para una clave existente. |
| Open(String, CngProvider) |
Crea una instancia de un CngKey objeto que representa una clave con nombre existente mediante el proveedor de almacenamiento de claves (KSP) especificado. |
| Open(String, CngProvider, CngKeyOpenOptions) |
Crea una instancia de un CngKey objeto que representa una clave con nombre existente, utilizando el proveedor de almacenamiento de claves (KSP) especificado y las opciones de apertura de claves. |
Open(String)
Crea una instancia de un CngKey objeto que representa una clave con nombre existente.
public:
static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);public static System.Security.Cryptography.CngKey Open(string keyName);static member Open : string -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyName As String) As CngKeyParámetros
- keyName
- String
Nombre de la clave.
Devoluciones
Una clave existente.
Excepciones
keyName es null.
La criptografía de próxima generación (CNG) no se admite en este sistema.
Todos los demás errores.
Comentarios
Esta sobrecarga usa los valores predeterminados siguientes:
Proveedor de almacenamiento de claves (KSP): MicrosoftSoftwareKeyStorageProvider. Use la Open(String, CngProvider) sobrecarga si desea especificar otro KSP.
Opciones de apertura de claves: CngKeyOpenOptions.None.
Se aplica a
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)
Crea una instancia de un CngKey objeto mediante un identificador para una clave existente.
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);[<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 CngKeyParámetros
- keyHandle
- SafeNCryptKeyHandle
Identificador de una clave existente.
- keyHandleOpenOptions
- CngKeyHandleOpenOptions
Uno de los valores de enumeración que indica si keyHandle representa una clave efímera o una clave con nombre.
Devoluciones
Una clave existente.
- Atributos
Excepciones
keyHandle es null.
keyHandle no es válido o tiene un formato incorrecto, o ya está cerrado. Esta excepción también se produce si la clave es una clave efímera creada por Common Language Runtime (CLR), pero no se especifica el EphemeralKey valor.
La criptografía de próxima generación (CNG) no se admite en este sistema.
Todos los demás errores.
Comentarios
Esta sobrecarga permite a los usuarios avanzados usar las clases de CNG incluso si se basan en la invocación de plataforma o en la funcionalidad de interoperabilidad administrada de C++. Por ejemplo, si tiene una biblioteca nativa que devuelve la clave como NCRYPT_KEY_HANDLE, esta sobrecarga le permite crear un contenedor administrado alrededor de la clave y usar las clases CNG para manipularla.
Al abrir una clave mediante su identificador, no puede determinar el estado efímero de la clave y debe especificarla usted mismo. Varias propiedades de la CngKey clase se basan en este valor para ser correctos. Por lo tanto, asegúrese de pasar el valor de marca correcto a los Open métodos.
Se aplica a
Open(String, CngProvider)
Crea una instancia de un CngKey objeto que representa una clave con nombre existente mediante el proveedor de almacenamiento de claves (KSP) especificado.
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);static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKeyPublic Shared Function Open (keyName As String, provider As CngProvider) As CngKeyParámetros
- keyName
- String
Nombre de la clave.
- provider
- CngProvider
KSP que contiene la clave.
Devoluciones
Una clave existente.
Excepciones
keyName o provider es null.
La criptografía de próxima generación (CNG) no se admite en este sistema.
Todos los demás errores.
Comentarios
A diferencia de la sobrecarga del Open(String) método, esta sobrecarga le permite especificar el proveedor. Además, se crea un valor predeterminado CngKeyOpenOptions de None y se enlaza a la clave.
Se aplica a
Open(String, CngProvider, CngKeyOpenOptions)
Crea una instancia de un CngKey objeto que representa una clave con nombre existente, utilizando el proveedor de almacenamiento de claves (KSP) especificado y las opciones de apertura de claves.
public:
static System::Security::Cryptography::CngKey ^ Open(System::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);public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);[<System.Security.SecurityCritical>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKeystatic 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 CngKeyParámetros
- keyName
- String
Nombre de la clave.
- provider
- CngProvider
KSP que contiene la clave.
- openOptions
- CngKeyOpenOptions
Combinación bit a bit de los valores de enumeración que especifican opciones para abrir la clave, como dónde se abre la clave desde (equipo o almacenamiento de usuario) y si se debe suprimir la solicitud de la interfaz de usuario.
Devoluciones
Una clave existente.
- Atributos
Excepciones
keyName o provider es null.
La criptografía de próxima generación (CNG) no se admite en este sistema.
Todos los demás errores.
Comentarios
A diferencia de la sobrecarga del Open(String) método, esta sobrecarga le permite especificar tanto el proveedor como las opciones de apertura de claves.