Funzione SHRegSetValue (shlwapi.h)
Non supportato.
Imposta un valore del Registro di sistema.
Usare RegSetValue al suo posto.
Sintassi
LSTATUS SHRegSetValue(
[in] HKEY hkey,
[in] LPCWSTR pszSubKey,
[in] LPCWSTR pszValue,
[in] SRRF srrfFlags,
[in] DWORD dwType,
[in] LPCVOID pvData,
[in] DWORD cbData
);
Parametri
[in] hkey
Tipo: HKEY
Handle per la chiave attualmente aperta o uno dei valori predefiniti seguenti.
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in] pszSubKey
Tipo: LPCWSTR
Puntatore a una stringa con terminazione Null che specifica il percorso relativo da hkey alla sottochiave da cui recuperare il valore. Questo parametro può essere NULL o una stringa vuota, nel qual caso i dati vengono recuperati dal percorso hkey .
[in] pszValue
Tipo: LPCWSTR
Puntatore a una stringa con terminazione Null contenente il nome del valore. Questo parametro può essere NULL o una stringa vuota, nel qual caso i dati vengono recuperati dal valore predefinito.
[in] srrfFlags
Tipo: SRRF
Uno o più flag SRRF che limitano i dati da impostare. È necessario specificare almeno un valore di restrizione del tipo (SRRF_RT).
[in] dwType
Tipo: DWORD
DWORD che indica il tipo di dati archiviati nel valore da impostare. Quando si usano valori predefiniti, il valore dwType di input è il tipo del valore predefinito. Per i valori possibili, vedere Tipi di dati del Registro di sistema. Se il flag di SRRF_NOEXPAND non è impostato, i tipi di REG_EXPAND_SZ vengono espansi automaticamente e restituiti come REG_SZ. Se le informazioni sul tipo non sono necessarie, questo parametro può essere NULL.
[in] pvData
Tipo: LPCVOID
Puntatore a un buffer contenente i dati del valore. Questo parametro può essere NULL se i dati non sono necessari.
[in] cbData
Tipo: DWORD
Dimensioni in byte del buffer dei dati di origine pvData. Questo valore può essere NULL solo se pvData è NULL.
Valore restituito
Tipo: LONG
Restituisce ERROR_SUCCESS in caso di esito positivo oppure un codice di errore diverso da zero definito in Winerror.h in caso contrario. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlwapi.h (include Shlwapi.h) |
DLL | Shlwapi.dll |