Fonction ResUtilGetBinaryValue (resapi.h)
Retourne une valeur binaire de la base de données du cluster.
Syntaxe
DWORD ResUtilGetBinaryValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[out, optional] LPBYTE *ppbOutValue,
[out] LPDWORD pcbOutValueSize
);
Paramètres
[in] hkeyClusterKey
Clé dans la base de données de cluster qui identifie l’emplacement de la valeur à récupérer.
[in] pszValueName
Pointeur vers une chaîne Unicode terminée par un caractère Null contenant le nom de la valeur à récupérer.
[out, optional] ppbOutValue
Adresse du pointeur vers la valeur récupérée.
[out] pcbOutValueSize
Pointeur vers un DWORD dans lequel la taille en octets de la mémoire tampon pointée par ppbOutValue est retournée.
Valeur retournée
Si les opérations réussissent, 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 l’allocation de mémoire pour la valeur. |
Remarques
La fonction utilitaire ResUtilGetBinaryValue se charge d’allouer la mémoire nécessaire pour la valeur, puis appelle la fonction d’API de clusterClusterRegQueryValue. Lorsque vous avez terminé avec la mémoire allouée, vous devez appeler la fonction LocalFree pour la libérer.
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 |