Fonction ResUtilSetSzValue (resapi.h)
Définit une valeur de chaîne dans la base de données de cluster. Le type PRESUTIL_SET_SZ_VALUE définit un pointeur vers cette fonction.
Syntaxe
DWORD ResUtilSetSzValue(
[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 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.
[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. |
Notes
La fonction utilitaire ResUtilSetSzValue alloue de la mémoire pour la nouvelle valeur et appelle la fonction d’API de clusterClusterRegSetValue. Si nécessaire, une valeur précédente est désallouée. La nouvelle valeur est copiée dans le contenu de ppszOutValue.
Veillez à appeler LocalFree sur *ppszOutValue pour éviter les fuites de mémoire.
N’appelez pas ResUtilSetSzValue à partir des fonctions de point d’entrée dll de ressource suivantes :
ResUtilSetSzValue 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 | resapi.h |
| Bibliothèque | ResUtils.lib |
| DLL | ResUtils.dll |