Fonction ResUtilSetBinaryValue (resapi.h)

Article
03/06/2024

Définit une valeur binaire dans la base de données de cluster.

Syntaxe

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

Paramètres

[in] hkeyClusterKey

Clé identifiant l’emplacement de la valeur binaire dans la base de données du cluster.

[in] pszValueName

Chaîne Unicode terminée par un caractère Null contenant le nom de la valeur à mettre à jour.

[in] pbNewValue

Pointeur vers la nouvelle valeur binaire.

[in] cbNewValueSize

Taille de la nouvelle valeur binaire.

[in, out, optional] ppbOutValue

Adresse d’un pointeur vers la nouvelle valeur binaire.

[in, out] pcbOutValueSize

Pointeur vers un DWORD dans lequel la taille en octets de la valeur pointée par ppbOutValue est retournée.

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. Voici un code d’erreur possible.

Code de retour	Description
ERROR_NOT_ENOUGH_MEMORY	Une erreur s’est produite lors de l’allocation de mémoire.

Remarques

La fonction utilitaire ResUtilSetBinaryValue alloue de la mémoire pour le pointeur ppbOutValue à l’aide de la fonction LocalAlloc, appelle la fonction d’API de cluster ClusterRegSetValue, puis copie la nouvelle valeur dans cette mémoire tampon. Si le pointeur n’est pas NULL, ResUtilSetBinaryValue le libère également. En tant qu’appelants de cette fonction, vous êtes responsable de la désaffectation de la mémoire tampon à l’aide de la fonction LocalFree.

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

ResUtilSetBinaryValue 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.

Configuration requise

Condition requise	Valeur
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	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll

Voir aussi

ClusterRegSetValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue

Partager via