Funzione ORSetValue

Imposta i dati per il valore di una chiave del Registro di sistema specificata in un hive del Registro di sistema offline.

Sintassi

DWORD ORSetValue(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpValueName,
  _In_     DWORD  dwType,
  _In_opt_ const BYTE *lpData,
  _In_     DWORD  cbData
);

Parametri

Handle [in]

Handle per una chiave del Registro di sistema aperta in un hive del Registro di sistema offline.

lpValueName [in, facoltativo]

Nome del valore da impostare. Se un valore con questo nome non è già presente nella chiave, la funzione lo aggiunge alla chiave.

Se lpValueName è NULL o una stringa vuota, "", la funzione imposta il tipo e i dati per il valore predefinito o senza nome della chiave.

Per altre informazioni, vedere Limiti delle dimensioni degli elementi del Registro di sistema.

Le chiavi del Registro di sistema non hanno valori predefiniti, ma possono avere un valore senza nome, che può essere di qualsiasi tipo.

dwType [in]

Tipo di dati a cui punta il parametro lpData . Per un elenco dei tipi possibili, vedere Tipi di valore del Registro di sistema.

lpData [in, facoltativo]

Dati da archiviare.

Per i tipi basati su stringhe, ad esempio REG_SZ, la stringa deve essere terminata con null. Per il tipo di dati REG_MULTI_SZ, la stringa deve essere terminata con due caratteri Null.

cbData [in]

Dimensioni delle informazioni a cui punta il parametro lpData , in byte. Se i dati sono di tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, cbData deve includere le dimensioni del carattere o dei caratteri null terminanti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore.

Commenti

Le dimensioni dei valori sono limitate dalla memoria disponibile. I valori lunghi (più di 2048 byte) devono essere archiviati come file con i nomi di file archiviati nel Registro di sistema. Ciò consente di eseguire in modo efficiente il Registro di sistema. Gli elementi dell'applicazione, ad esempio icone, bitmap e file eseguibili devono essere archiviati come file e non vengono inseriti nel Registro di sistema.

Requisiti

Requisito	Valore
Componente ridistribuibile	Libreria del Registro di sistema offline di Windows versione 1.0 o successiva
Intestazione	Offreg.h
DLL	Offreg.dll

Vedi anche

ORCreateKey

OROpenKey