SHRegCreateUSKeyW 函数 (shlwapi.h)

项目
08/26/2023

在特定于用户的子树 (HKEY_CURRENT_USER 或HKEY_LOCAL_MACHINE) 中创建或打开注册表子项。

语法

LSTATUS SHRegCreateUSKeyW(
                 LPCWSTR pwzPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

参数

pwzPath

TBD

[in] samDesired

类型： REGSAM

所需的安全访问。有关安全访问的详细信息，请参阅 REGSAM。

[in, optional] hRelativeUSKey

类型： HUSKEY

要用作相对路径基的键。如果 pszPath 是相对路径，则它指定的键将相对于 hRelativeUSKey。如果 pszPath 是绝对路径，请将 hRelativeUSKey 设置为 NULL。然后，将在 HKEY_LOCAL_MACHINE 或 HKEY_CURRENT_USER 下创建密钥，具体取决于 dwFlags 的值。

[out] phNewUSKey

类型： PHUSKEY

指向 HUSKEY 的指针，该 HUSKEY 将接收新密钥的句柄。

[in] dwFlags

类型：DWORD

应在其下打开密钥的基键。这可以是以下一个或多个值。

SHREGSET_HKCU

在 “HKEY_CURRENT_USER”下创建/打开密钥。仅当密钥为空时，才会创建密钥。

SHREGSET_FORCE_HKCU

在 “HKEY_CURRENT_USER”下创建/打开密钥。创建一个键，即使它不为空。

SHREGSET_HKLM

在 “HKEY_LOCAL_MACHINE”下创建/打开密钥。仅当密钥为空时，才会创建密钥。

SHREGSET_FORCE_HKLM

在 “HKEY_LOCAL_MACHINE”下创建/打开密钥。创建一个键，即使它不为空。

SHREGSET_DEFAULT

仅当) 为空时，HKEY_CURRENT_USER (强制) 和 HKEY_LOCAL_MACHINE (下创建/打开密钥。此标志等效于 (SHREGSET_FORCE_HKCU | SHREGSET_HKLM) 。

返回值

类型： LSTATUS

如果成功，则返回ERROR_SUCCESS，否则返回 Winerror.h 中定义的非零错误代码。可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用，以检索错误的一般说明。

注解

如果要将值写入新密钥，请使用 SHRegWriteUSValue 写入每个值，并传递通过 phNewUSKey 返回的 HUSKEY 句柄。完成后，使用 SHRegCloseUSKey 关闭特定于用户的注册表项。

注意

shlwapi.h 标头将 SHRegCreateUSKey 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
Library	Shlwapi.lib
DLL	Shlwapi.dll (4.71 或更高版本)