Funzione ClusterRegSetValue (clusapi.h)

Articolo
08/22/2023

Imposta un valore per una chiave del database cluster .

Sintassi

DWORD ClusterRegSetValue(
  [in] HKEY       hKey,
  [in] LPCWSTR    lpszValueName,
  [in] DWORD      dwType,
  [in] const BYTE *lpData,
  [in] DWORD      cbData
);

Parametri

[in] hKey

Gestire in una chiave del database del cluster.

[in] lpszValueName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del valore da impostare. Se un valore con questo nome non è già presente nella risorsa, ClusterRegSetValue lo aggiunge alla risorsa.

[in] dwType

Tipo di informazioni da archiviare come dati del valore. Questo parametro può avere uno dei valori seguenti. Per altre informazioni, vedere Tipi di valore del Registro di sistema.

REG_BINARY (3)

Dati binari in qualsiasi forma.

REG_DWORD (4)

Numero a 32 bit.

REG_DWORD_BIG_ENDIAN (5)

Numero a 32 bit archiviato in formato big-endian.

REG_EXPAND_SZ (2)

Stringa Unicode con terminazione Null che contiene riferimenti non espansi alle variabili di ambiente, ad esempio "%PATH%").

REG_MULTI_SZ (6)

Sequenza di stringhe con terminazione Null, terminate da una stringa vuota (\0).

Di seguito è riportato un esempio:

String1\0String2\0String3\0LastString\0\0

Il primo \0 termina la prima stringa, il secondo all'ultimo \0 termina l'ultima stringa e il valore finale \0 termina la sequenza. Si noti che il carattere di terminazione finale deve essere inserito nella lunghezza della stringa.

REG_NONE (0)

Nessun tipo valore definito.

REG_QWORD (11)

Numero a 64 bit.

REG_SZ (1)

Stringa Unicode con terminazione Null.

[in] lpData

Puntatore ai dati da archiviare con il nome a cui punta lpszValueName.

[in] cbData

Numero di byte nei dati a cui punta il parametro lpbData . Se i dati sono di tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, cbData deve includere le dimensioni del carattere di terminazione Null.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema.

Commenti

Non chiamare ClusterRegSetValue dalle funzioni del punto di ingresso della DLL di risorse seguenti:

ClusterRegSetValue può essere chiamato in modo sicuro da qualsiasi altra funzione del punto di ingresso della DLL di risorse o da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

ClusterRegOpenKey

Getlasterror

Condividi tramite