CngKey.GetProperty(String, CngPropertyOptions) CngKey.GetProperty(String, CngPropertyOptions) CngKey.GetProperty(String, CngPropertyOptions) CngKey.GetProperty(String, CngPropertyOptions) Method

定義

名前および一連のプロパティ オプションを指定してプロパティを取得します。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

パラメーター

name
String String String String

目的のプロパティの名前。The name of the desired property.

options
CngPropertyOptions CngPropertyOptions CngPropertyOptions CngPropertyOptions

名前付きプロパティのオプションを示す列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that specify options for the named property.

戻り値

指定したプロパティの未処理の値を格納しているオブジェクト。An object that contains the raw value of the specified property.

例外

上記以外のすべてのエラー。All other errors.

注釈

このメソッドの目的は、任意のキーのプロパティの値を返すです。The purpose of this method is to return the value of an arbitrary property of the key. プロパティを取得する一般的な方法は、によって提供されるプロパティのアクセサーを使用して、CngKeyクラス。The typical way to retrieve properties is by using the property accessors provided by the CngKey class. CngKey すべてではなく、いくつかのプロパティのラッパーを提供します。CngKey provides wrappers for several, but not all, properties. GetPropertyメソッドは主にラップされていないプロパティの値へのアクセスに使用します。The GetProperty method is primarily used to access the value of a property that is not wrapped.

このメソッドは、次の場合に便利です。This method is useful in the following cases:

  • オペレーティング システムの新しいバージョンでは、新しいラッパーを持たない Cryptography Next Generation (CNG) キー プロパティをサポートします。A new version of the operating system supports a new Cryptography Next Generation (CNG) key property that does not have a wrapper.

  • キーには、カスタム プロパティを追加します。You add a custom property to the key.

optionsパラメーターは、具体的を次を示すために使用します。The options parameter is specifically used to indicate the following:

  • プロパティが、組み込みまたはカスタムかどうか。Whether the property is built-in, or custom.

  • かどうか、キーを持つプロパティを永続化する必要があります。Whether the property should be persisted with the key.

これらのオプションを使用すると、プロパティまたはプロパティが見つかりません値と一致する必要があります。These options must match the value that the property was set with, or the property will not be found.

CryptographicException プロパティが見つからない場合にスローされます。CryptographicException is thrown if the property cannot be found. 呼び出す必要があります、HasPropertyでメソッドをラップする代わりに、例外を回避するには、最初のメソッドを呼び出す、try/catchブロックします。You should call the HasProperty method first to avoid the exception instead of wrapping the method call in a try/catch block.

セキュリティ

SecurityPermission
アンマネージ コードを呼び出すアクセス許可。for permission to call unmanaged code. 要求値:LinkDemandします。Demand value: LinkDemand. 関連付けられた列挙体。 UnmanagedCodeAssociated enumeration: UnmanagedCode

適用対象