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。

戻り値

関数の成功または失敗を示す状態コードを返します。 可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード 説明
ERROR_SUCCESS
 関数は成功しました。
NTE_INVALID_PARAMETER
 pwszName パラメーターを NULL にすることはできません。また、 パラメーターが指す値を空の文字列にすることはできません。
NTE_BAD_FLAGS
 dwFlags パラメーターは、0 またはNCRYPT_MACHINE_KEY_FLAGにする必要があります。

注釈

この関数を使用して作成されたレジストリ キーは揮発性ではありません。 情報はファイルに格納され、コンピューターのシャットダウン時に保持されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ncryptprotect.h
Library NCrypt.lib
[DLL] NCrypt.dll

こちらもご覧ください

CNG DPAPI 関数

NCryptQueryProtectionDescriptorName