Fonction ClusterRegSetValue (clusapi.h)

Article
08/22/2023

Définit une valeur pour une clé de base de données de cluster .

Syntaxe

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

Paramètres

[in] hKey

Gérez vers une clé de base de données de cluster.

[in] lpszValueName

Pointeur vers une chaîne Unicode terminée par null contenant le nom de la valeur à définir. Si aucune valeur portant ce nom n’est déjà présente dans la ressource, ClusterRegSetValue l’ajoute à la ressource.

[in] dwType

Type d’informations à stocker en tant que données de la valeur. Ce paramètre peut prendre les valeurs suivantes. Pour plus d’informations, consultez Types de valeurs de registre.

REG_BINARY (3)

Données binaires dans tout formulaire.

REG_DWORD (4)

Nombre 32 bits.

REG_DWORD_BIG_ENDIAN (5)

Nombre 32 bits stocké au format big-endian.

REG_EXPAND_SZ (2)

Chaîne Unicode terminée par null qui contient des références non expirées à des variables d’environnement (par exemple, « %PATH% »).

REG_MULTI_SZ (6)

Séquence de chaînes terminées par un caractère Null, terminée par une chaîne vide (\0).

Par exemple :

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

Le premier \0 termine la première chaîne, le deuxième au dernier \0 termine la dernière chaîne et le dernier \0 termine la séquence. Notez que le terminateur final doit être pris en compte dans la longueur de la chaîne.

REG_NONE (0)

Aucun type valeur défini.

REG_QWORD (11)

Nombre 64 bits.

REG_SZ (1)

Chaîne Unicode terminée par un caractère Null.

[in] lpData

Pointeur vers les données à stocker avec le nom pointé par lpszValueName.

[in] cbData

Nombre d’octets dans les données pointées par le paramètre lpbData . Si les données sont de type REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, cbData doit inclure la taille du caractère de fin null.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système.

Notes

N’appelez pas ClusterRegSetValue à partir des fonctions de point d’entrée dll de ressource suivantes :

ClusterRegSetValue peut être appelé en toute sécurité à partir de n’importe quelle autre fonction de point d’entrée DLL de ressource ou à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

ClusterRegOpenKey

Obtenir la dernière erreur

Partager via