CngKey.GetProperty(String, CngPropertyOptions) Méthode

Définition

Obtient une propriété, étant donné un nom et un jeu d'options de propriété.Gets a property, given a name and a set of property options.

public:
 System::Security::Cryptography::CngProperty GetProperty(System::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
Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Paramètres

name
String

Nom de la propriété souhaitée.The name of the desired property.

options
CngPropertyOptions

Combinaison d'opérations de bits des valeurs d'énumération qui spécifient les options pour la propriété nommée.A bitwise combination of the enumeration values that specify options for the named property.

Retours

Objet qui contient la valeur brute de la propriété spécifiée.An object that contains the raw value of the specified property.

Attributs

Exceptions

name a la valeur null.name is null.

Toutes les autres erreurs.All other errors.

Remarques

L’objectif de cette méthode est de retourner la valeur d’une propriété arbitraire de la clé.The purpose of this method is to return the value of an arbitrary property of the key. La méthode habituelle pour récupérer des propriétés consiste à utiliser les accesseurs de propriété fournis CngKey par la classe.The typical way to retrieve properties is by using the property accessors provided by the CngKey class. CngKeyfournit des wrappers pour plusieurs propriétés, mais pas toutes.CngKey provides wrappers for several, but not all, properties. La GetProperty méthode est principalement utilisée pour accéder à la valeur d’une propriété qui n’est pas encapsulée.The GetProperty method is primarily used to access the value of a property that is not wrapped.

Cette méthode est utile dans les cas suivants :This method is useful in the following cases:

  • Une nouvelle version du système d’exploitation prend en charge une nouvelle propriété de clé CNG (Cryptography Next Generation) qui n’a pas de wrapper.A new version of the operating system supports a new Cryptography Next Generation (CNG) key property that does not have a wrapper.

  • Vous ajoutez une propriété personnalisée à la clé.You add a custom property to the key.

Le options paramètre est utilisé spécifiquement pour indiquer les éléments suivants :The options parameter is specifically used to indicate the following:

  • Indique si la propriété est intégrée ou personnalisée.Whether the property is built-in, or custom.

  • Indique si la propriété doit être rendue persistante avec la clé.Whether the property should be persisted with the key.

Ces options doivent correspondre à la valeur avec laquelle la propriété a été définie, ou la propriété ne sera pas trouvée.These options must match the value that the property was set with, or the property will not be found.

CryptographicExceptionest levé si la propriété est introuvable.CryptographicException is thrown if the property cannot be found. Vous devez d’abord HasProperty appeler la méthode pour éviter l’exception au lieu d’encapsuler l' try/catch appel de méthode dans un bloc.You should call the HasProperty method first to avoid the exception instead of wrapping the method call in a try/catch block.

Sécurité

SecurityPermission
pour obtenir l’autorisation d’appeler du code non managé.for permission to call unmanaged code. Valeur de la LinkDemanddemande:.Demand value: LinkDemand. Énumération associée:UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à