SHRegSetValue 函式 (shlwapi.h)

發行項
03/02/2024

不支援。

設定登錄值。

請在其位置使用 RegSetValue 。

語法

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] LPCVOID pvData,
  [in] DWORD   cbData
);

參數

[in] hkey

類型： HKEY

目前開啟之索引鍵的句柄，或任何下列任何預先定義的值。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] pszSubKey

類型： LPCWSTR

Null 終止字串的指標，指定要從 hkey 到要從中擷取值之子機碼的相對路徑。此參數可以是 NULL 或空字串，在此情況下，會從 hkey 位置擷取數據。

[in] pszValue

類型： LPCWSTR

包含值名稱之 Null 終止字串的指標。此參數可以是 NULL 或空字串，在此情況下，會從預設值擷取數據。

[in] srrfFlags

類型： SRRF

限制要設定數據的一或多個 SRRF 旗標。至少必須指定一個類型限制 (SRRF_RT) 值。

[in] dwType

類型： DWORD

DWORD，表示儲存在要設定之值中的數據型別。使用預設值時，輸入 dwType 是預設值的類型。如需可能的值，請參閱登錄數據類型。如果未設定SRRF_NOEXPAND旗標，REG_EXPAND_SZ類型會自動展開並傳回為REG_SZ。如果不需要類型資訊，此參數可以是 NULL。

[in] pvData

類型： LPCVOID

緩衝區的指標，其中包含值的數據。如果不需要數據，這個參數可以是 NULL 。

[in] cbData

類型： DWORD

源數據緩衝區 pvData 的大小，以位元組為單位。只有當 pvData 為 NULL 時，這個值才能是 NULL。

傳回值

類型： LONG

如果成功，則傳回ERROR_SUCCESS，否則會傳回 Winerror.h 中定義的非零錯誤碼。您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來擷取錯誤的一般描述。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlwapi.h (包含 Shlwapi.h)
Dll	Shlwapi.dll

另請參閱

RegSetKeyValue

共用方式為