Fonction ResUtilSetMultiSzValue (resapi.h)

Article
03/04/2024

Définit une valeur de chaîne multiple dans la base de données de cluster. Le type PRESUTIL_SET_MULTI_SZ_VALUE définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilSetMultiSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in]                DWORD   cbNewValueSize,
  [out, optional]     LPWSTR  *ppszOutValue,
  [in, out, optional] LPDWORD pcbOutValueSize
);

Paramètres

[in] hkeyClusterKey

Clé identifiant l’emplacement de la valeur de chaîne multiple dans la base de données du cluster.

[in] pszValueName

Chaîne Unicode terminée par null contenant le nom de la valeur à mettre à jour.

[in] pszNewValue

Pointeur vers la nouvelle valeur de chaîne multiple.

[in] cbNewValueSize

Taille de la nouvelle valeur.

[out, optional] ppszOutValue

Pointeur vers un pointeur de chaîne qui reçoit une copie de la valeur mise à jour. S’il est utilisé, les appelants doivent appeler LocalFree sur *ppszOutValue.

[in, out, optional] pcbOutValueSize

Pointeur qui reçoit la taille de la nouvelle valeur.

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 la tentative d’allocation de mémoire.

Remarques

La fonction de l’utilitaire ResUtilSetMultiSzValue alloue de la mémoire pour la nouvelle valeur et appelle la fonction d’API de cluster ClusterRegSetValue.

Une valeur de chaîne multiple est une grande chaîne contenant des chaînes Unicode plus petites, contiguës et terminées par un caractère null supplémentaire après la dernière chaîne.

Veillez à appeler LocalFree sur *ppszOutValue pour éviter les fuites de mémoire.

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

ResUtilSetMultiSzValue 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

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetSzValue

Partager via