CngKey.GetProperty(String, CngPropertyOptions) Méthode

Référence

Définition

Espace de noms:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Cng.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Source:: Cng.NotSupported.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une propriété, étant donné un nom et un jeu d'options de propriété.

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

Paramètres

name: String

Nom de la propriété souhaitée.

options: CngPropertyOptions

Combinaison d'opérations de bits des valeurs d'énumération qui spécifient les options pour la propriété nommée.

Retours

CngProperty

Objet qui contient la valeur brute de la propriété spécifiée.

Attributs: SecurityCriticalAttribute

Exceptions

ArgumentNullException

name a la valeur null.

CryptographicException

Toutes les autres erreurs.

Remarques

L’objectif de cette méthode est de retourner la valeur d’une propriété arbitraire de la clé. La méthode classique pour récupérer des propriétés consiste à utiliser les accesseurs de propriété fournis par la CngKey classe . CngKey fournit des wrappers pour plusieurs propriétés, mais pas toutes. La GetProperty méthode est principalement utilisée pour accéder à la valeur d’une propriété qui n’est pas encapsulée.

Cette méthode est utile dans les cas suivants :

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.
Vous ajoutez une propriété personnalisée à la clé.

Le options paramètre est spécifiquement utilisé pour indiquer les éléments suivants :

Indique si la propriété est intégrée ou personnalisée.
Indique si la propriété doit être conservée avec la clé.

Ces options doivent correspondre à la valeur avec laquelle la propriété a été définie, sinon la propriété est introuvable.

CryptographicException est levée si la propriété est introuvable. Vous devez d’abord appeler la HasProperty méthode pour éviter l’exception au lieu d’encapsuler l’appel de méthode dans un try/catch bloc.

S’applique à