Funzione SHSetValueA (shlwapi.h)

  • Articolo

Imposta il valore di una chiave del Registro di sistema.

Sintassi

LSTATUS SHSetValueA(
  [in]           HKEY    hkey,
  [in, optional] LPCSTR  pszSubKey,
  [in, optional] LPCSTR  pszValue,
  [in]           DWORD   dwType,
  [in, optional] 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, optional] pszSubKey

Tipo: LPCTSTR

Indirizzo di una stringa con terminazione Null che specifica il nome della sottochiave a cui è associato un valore. Può essere NULL o un puntatore a una stringa vuota. In questo caso, il valore viene aggiunto alla chiave identificata dal parametro hkey .

[in, optional] pszValue

Tipo: LPCTSTR

Indirizzo di una stringa con terminazione Null che specifica il valore. Questo valore può essere NULL.

[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: LPCVOID

Puntatore a un buffer contenente i dati da impostare per il valore specificato. Questo valore può essere NULL.

[in] cbData

Tipo: DWORD

Lunghezza, in byte, del buffer a cui punta il parametro pvData . Se i dati sono una stringa con terminazione Null, questa lunghezza include il carattere Null di terminazione.

Valore restituito

Tipo: LSTATUS

Restituisce ERROR_SUCCESS in caso di esito positivo; in caso contrario, un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.

Commenti

Nota

L'intestazione shlwapi.h definisce SHSetValue 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)