NCryptRegisterProtectionDescriptorName 関数 (ncryptprotect.h)
NCryptRegisterProtectionDescriptorName 関数は、保護記述子の表示名と関連付けられているルール文字列を登録します。
構文
SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
[in] LPCWSTR pwszName,
[in, optional] LPCWSTR pwszDescriptorString,
DWORD dwFlags
);
パラメーター
[in] pwszName
登録する記述子の表示名を含む null で終わる Unicode 文字列へのポインター。
[in, optional] pwszDescriptorString
保護記述子規則を含む null で終わる Unicode 文字列へのポインター。 このパラメーターが NULL であるか、文字列が空の場合、 pwszName パラメーター用に以前に作成されたレジストリ値は削除されます。
dwFlags
新しいエントリを登録するレジストリ ハイブを示す定数。 この値がゼロ (0) の場合、レジストリ ルートは HKEY_CURRENT_USER。 この値が NCRYPT_MACHINE_KEY_FLAG場合、ルートは HKEY_LOCAL_MACHINE。
戻り値
関数の成功または失敗を示す状態コードを返します。 可能なリターン コードには、次のものが含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
関数は成功しました。 |
|
pwszName パラメーターを NULL にすることはできません。また、 パラメーターが指す値を空の文字列にすることはできません。 |
|
dwFlags パラメーターは、0 またはNCRYPT_MACHINE_KEY_FLAGにする必要があります。 |
注釈
この関数を使用して作成されたレジストリ キーは揮発性ではありません。 情報はファイルに格納され、コンピューターのシャットダウン時に保持されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ncryptprotect.h |
Library | NCrypt.lib |
[DLL] | NCrypt.dll |