Fonction ResUtilEnumProperties (resapi.h)

Article
03/13/2024

Énumère les noms de propriétés d’un objet de cluster. Le type PRESUTIL_ENUM_PROPERTIES définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilEnumProperties(
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] LPWSTR                       pszOutProperties,
  [in]  DWORD                        cbOutPropertiesSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

Paramètres

[in] pPropertyTable

Pointeur vers un tableau de structures RESUTIL_PROPERTY_ITEM décrivant les propriétés à énumérer.

[out] pszOutProperties

Pointeur vers la mémoire tampon de sortie dans laquelle renvoyer les noms de toutes les propriétés dans plusieurs formats de chaîne. Chaque nom de propriété est stocké sous la forme d’une chaîne Unicode terminée par null. Le nom de la dernière propriété est suivi d’un caractère de fin null final.

[in] cbOutPropertiesSize

Taille en octets de la mémoire tampon de sortie pointée vers pszOutProperties.

[out] pcbBytesReturned

Pointeur vers le nombre total d’octets dans la liste de propriétés pointée par pszOutProperties.

[out] pcbRequired

Nombre d’octets requis si la mémoire tampon de sortie est trop petite.

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 les codes d’erreur possibles.

Code de retour	Description
ERROR_BAD_ARGUMENTS	Un ou plusieurs des paramètres d’entrée n’étaient pas valides.
ERROR_NOT_ENOUGH_MEMORY	Une erreur s’est produite lors de l’allocation de la mémoire.
ERROR_MORE_DATA	La taille de la mémoire tampon de sortie est trop petite pour contenir les données obtenues. Le paramètre pcbRequired pointe vers la taille correcte.

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

Voir aussi

RESUTIL_PROPERTY_ITEM

Partager via