Funzione SHSetValueA (shlwapi.h)
Imposta il valore di una chiave del Registro di sistema.
LSTATUS SHSetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR pszSubKey,
[in, optional] LPCSTR pszValue,
[in] DWORD dwType,
[in, optional] LPCVOID pvData,
[in] DWORD cbData
);
[in] hkey
Tipo: HKEY
Handle per la chiave attualmente aperta o uno dei valori predefiniti seguenti.
[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
Tipo: LSTATUS
Restituisce ERROR_SUCCESS se ha esito positivo; in caso contrario, un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
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 | Finestre |
intestazione |
shlwapi.h |
libreria |
Shlwapi.lib |
dll | Shlwapi.dll (versione 4.71 o successiva) |