Fonction ResUtilSetExpandSzValue (resapi.h)
Définit une valeur de chaîne extensible dans la base de données de cluster. Le type PRESUTIL_SET_EXPAND_SZ_VALUE définit un pointeur vers cette fonction.
Syntaxe
DWORD ResUtilSetExpandSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in, out, optional] LPWSTR *ppszOutString
);
Paramètres
[in] hkeyClusterKey
Clé identifiant l’emplacement de la valeur de chaîne extensible 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 extensible.
[in, out, optional] ppszOutString
Pointeur vers un pointeur de chaîne qui reçoit une copie de la valeur mise à jour. Si elle est utilisée, les appelants doivent appeler LocalFree sur *ppszOutValue.
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 |
|---|---|
|
Une erreur s’est produite lors de la tentative d’allocation de mémoire. |
Remarques
La fonction utilitaire ResUtilSetExpandSzValue alloue de la mémoire pour la nouvelle valeur et appelle la fonction d’API de clusterClusterRegSetValue.
Une valeur de chaîne extensible contient des données qui représentent une chaîne Unicode terminée par un caractère Null contenant des références non expirées à des variables d’environnement telles que « %SystemRoot% ».
Veillez à appeler LocalFree sur *ppszOutValue pour éviter les fuites de mémoire.
N’appelez pas ResUtilSetExpandSzValue à partir des fonctions de point d’entrée dll de ressource suivantes :
ResUtilSetExpandSzValue peut être appelé en toute sécurité à partir de toute 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 |