Condividi tramite


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

Vedi anche

RegSetKeyValue