CngKey.GetProperty(String, CngPropertyOptions) 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í.
Obtiene una propiedad, según un nombre y un conjunto de opciones de propiedad.
public:
System::Security::Cryptography::CngProperty GetProperty(System::String ^ name, System::Security::Cryptography::CngPropertyOptions options);public System.Security.Cryptography.CngProperty GetProperty (string name, System.Security.Cryptography.CngPropertyOptions options);[System.Security.SecurityCritical]
public System.Security.Cryptography.CngProperty GetProperty (string name, System.Security.Cryptography.CngPropertyOptions options);member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty[<System.Security.SecurityCritical>]
member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngPropertyPublic Function GetProperty (name As String, options As CngPropertyOptions) As CngPropertyParámetros
- name
- String
Nombre de la propiedad deseada.
- options
- CngPropertyOptions
Combinación bit a bit de los valores de enumeración que especifican opciones para la propiedad con nombre.
Devoluciones
Objeto que contiene el valor sin formato de la propiedad especificada.
- Atributos
Excepciones
name es null.
Todos los demás errores.
Comentarios
El propósito de este método es devolver el valor de una propiedad arbitraria de la clave. La forma típica de recuperar propiedades es mediante los descriptores de acceso de propiedad proporcionados por la CngKey clase . CngKey proporciona contenedores para varias propiedades, pero no todas. El GetProperty método se usa principalmente para tener acceso al valor de una propiedad que no está encapsulada.
Este método es útil en los casos siguientes:
Una nueva versión del sistema operativo admite una nueva propiedad de clave Cryptography Next Generation (CNG) que no tiene un contenedor.
Agregue una propiedad personalizada a la clave.
El options parámetro se usa específicamente para indicar lo siguiente:
Si la propiedad está integrada o personalizada.
Si la propiedad debe conservarse con la clave.
Estas opciones deben coincidir con el valor con el que se estableció la propiedad o no se encontrará la propiedad .
CryptographicException se produce si no se encuentra la propiedad . Primero debe llamar al HasProperty método para evitar la excepción en lugar de ajustar la llamada al método en un try/catch bloque .
