Funzione SHRegSetUSValueA (shlwapi.h)

Imposta un valore della sottochiave del Registro di sistema in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

LSTATUS SHRegSetUSValueA(
  [in]           LPCSTR     pszSubKey,
  [in]           LPCSTR     pszValue,
  [in]           DWORD      dwType,
  [in, optional] const void *pvData,
  [in, optional] DWORD      cbData,
  [in, optional] DWORD      dwFlags
);

Parametri

[in] pszSubKey

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null con il nome della sottochiave.

[in] pszValue

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che specifica il nome del valore.

[in] dwType

Tipo: DWORD

Tipo di dati da archiviare. Questo parametro deve essere il tipo di REG_SZ . Per altre informazioni, vedere Tipi di dati del Registro di sistema.

[in, optional] pvData

Tipo: LPVOID*

Puntatore a una stringa con terminazione Null contenente il valore da impostare per la chiave specificata.

[in, optional] cbData

Tipo: DWORD

Lunghezza, in byte, della stringa a cui punta il parametro pvData , non incluso il carattere null di terminazione.

[in, optional] dwFlags

Tipo: DWORD

Flag che indicano dove devono essere scritti i dati.

SHREGSET_HKCU

Scrivere in HKEY_CURRENT_USER se vuoto.

SHREGSET_FORCE_HKCU

Scrivere in HKEY_CURRENT_USER.

SHREGSET_HKLM

Scrivere in HKEY_LOCAL_MACHINE se vuoto.

SHREGSET_FORCE_HKLM

Scrivere in HKEY_LOCAL_MACHINE.

SHREGSET_DEFAULT

Equivalente a (SHREGSET_FORCE_HKCU SHREGSET_HKLM | ).

Valore restituito

Tipo: LSTATUS

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.

Commenti

Questa funzione apre la chiave ogni volta che viene usata. Se il codice prevede l'impostazione di una serie di valori nella stessa chiave, è più efficiente aprire la chiave una volta con SHRegOpenUSKey e quindi usare SHRegWriteUSValue per scrivere i dati.

Nota

L'intestazione shlwapi.h definisce SHRegSetUSValue come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)