NCryptGetProperty 関数 (ncrypt.h)

NCryptGetProperty 関数は、キー ストレージ オブジェクトの名前付きプロパティの値を取得します。

構文

SECURITY_STATUS NCryptGetProperty(
  [in]  NCRYPT_HANDLE hObject,
  [in]  LPCWSTR       pszProperty,
  [out] PBYTE         pbOutput,
  [in]  DWORD         cbOutput,
  [out] DWORD         *pcbResult,
  [in]  DWORD         dwFlags
);

パラメーター

[in] hObject

プロパティを取得するオブジェクトのハンドル。 プロバイダー ハンドル (NCRYPT_PROV_HANDLE) またはキー ハンドル (NCRYPT_KEY_HANDLE) を指定できます。

[in] pszProperty

取得するプロパティの名前を含む null で終わる Unicode 文字列へのポインター。 これには、定義済みの キー ストレージ プロパティ識別子またはカスタム プロパティ識別子 のいずれかを指定できます。

[out] pbOutput

プロパティ値を受け取るバッファーのアドレス。 cbOutput パラメーターには、このバッファーのサイズが含まれています。

バッファーに必要なサイズを計算するには、このパラメーターを NULL に設定 します。 必要なサイズ (バイト単位) は、 pcbResult パラメーターが指す場所で返されます。

[in] cbOutput

pbOutput バッファーのサイズ (バイト単位)。

[out] pcbResult

pbOutput バッファーにコピーされたバイト数を受け取る DWORD 変数へのポインター。

pbOutput パラメーターが NULL の場合、バッファーに必要なサイズ (バイト単位) は、このパラメーターが指す場所に配置されます。

[in] dwFlags

関数の動作を変更するフラグ。 0 または次の値を指定できます。

NCRYPT_SECURITY_DESCR_PROPERTY プロパティの場合、このパラメーターには、取得するセキュリティ記述子の部分を識別する次のいずれかの値も含まれている必要があります。

戻り値

関数の成功または失敗を示す状態コードを返します。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

注釈

サービスは 、StartService 関数からこの関数を呼び出してはなりません。 サービスがその関数から StartService この関数を呼び出すと、デッドロックが発生し、サービスが応答を停止する可能性があります。

要件