Fonction ResUtilGetSzValue (resapi.h)
Retourne une valeur de chaîne de la base de données de cluster.
Syntaxe
LPWSTR ResUtilGetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName
);
Paramètres
[in] hkeyClusterKey
Clé identifiant l’emplacement de la valeur dans la base de données du cluster.
[in] pszValueName
Chaîne Unicode terminée par null contenant le nom de la valeur à récupérer.
Valeur retournée
Si l’opération réussit, la fonction retourne un pointeur vers une mémoire tampon contenant la valeur de chaîne.
Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations, appelez la fonction GetLastError.
Remarques
La fonction de l’utilitaire ResUtilGetSzValue alloue la mémoire nécessaire pour la valeur du paramètre de chaîne avant d’appeler la fonction d’API de clusterClusterRegQueryValue pour accéder à la base de données du cluster. Une fois cette mémoire terminée, vous devez appeler la fonction LocalFree pour la libérer.
ResUtilGetSzValue prend également en charge les formats de chaîne extensible et multiples.
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 |