Partager via


Fonction ResUtilGetMultiSzValue (resapi.h)

Retourne une valeur de chaîne multiple de la base de données de cluster.

Syntaxe

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           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

Pointeur vers une chaîne Unicode terminée par null contenant le nom de la valeur à récupérer.

[out, optional] ppszOutValue

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 ppszOutValue 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
ERROR_NOT_ENOUGH_MEMORY
Une erreur s’est produite lors de l’allocation de mémoire.

Remarques

Lorsque vous avez terminé avec la mémoire allouée pour la valeur retournée par la fonction utilitaire ResUtilGetMultiSzValue , 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

Voir aussi

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue