CngKey.GetProperty(String, CngPropertyOptions) Método

Referencia

Definición

Espacio de nombres:: System.Security.Cryptography

Ensamblado:: System.Security.Cryptography.Cng.dll

Ensamblado:: System.Security.Cryptography.dll

Ensamblado:: System.Core.dll

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

CngProperty

Objeto que contiene el valor sin formato de la propiedad especificada.

Atributos: SecurityCriticalAttribute

Excepciones

ArgumentNullException

name es null.

CryptographicException

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