Funzione ClusterRegQueryValue (clusapi.h)
Restituisce il nome, il tipo e i componenti dati associati a un valore per una chiave del database cluster aperta.
Sintassi
LONG ClusterRegQueryValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[out, optional] LPDWORD lpdwValueType,
[out, optional] LPBYTE lpData,
[in, out, optional] LPDWORD lpcbData
);
Parametri
[in] hKey
Handle della chiave del database del cluster su cui eseguire una query.
[in] lpszValueName
Puntatore a una stringa Unicode con terminazione Null contenente il nome del valore su cui eseguire la query.
[out, optional] lpdwValueType
Puntatore al tipo di valore della chiave. Questo parametro può essere NULL se il tipo non è obbligatorio; in caso contrario, il valore restituito tramite questo parametro è uno dei seguenti.
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.
[out, optional] lpData
Puntatore ai dati del valore. Questo parametro può essere NULL se i dati non sono necessari.
[in, out, optional] lpcbData
In input, puntatore al conteggio dei byte nel buffer a cui punta il parametro lpbData . Nell'output, puntatore al conteggio dei byte nei dati del valore, che viene inserito nel contenuto di lpbData se il chiamante passa un puntatore valido.
Il parametro lpbData può essere NULL solo se lpbDataè null.
Valore restituito
La funzione restituisce uno dei valori seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Il buffer a cui punta lpbData non è sufficientemente grande da contenere i dati per il valore. ClusterRegQueryValue archivia le dimensioni necessarie nel contenuto di lpbData. |
Commenti
Se lpbData è NULL, la funzione ClusterRegQueryValue restituisce ERROR_SUCCESS e archivia le dimensioni dei dati del valore nel contenuto di lpbData. Queste informazioni consentono al chiamante di allocare correttamente un buffer per contenere i dati.
Se lpdwValueType è impostato su REG_SZ, REG_MULTI_SZ o REG_EXPAND_SZ, lpbData include anche un carattere di terminazione NULL .
Requisiti
| Requisito | Valore |
|---|---|
| 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 |