Compartir vía


CngKey.GetProperty(String, CngPropertyOptions) Método

Definición

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.CngProperty
Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

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

Se aplica a