Fonction ResUtilFindBinaryProperty (resapi.h)

Article
03/04/2024

Localise une propriété binaire spécifiée dans une liste de propriétés et peut également retourner la valeur de la propriété. Le type PRESUTIL_FIND_BINARY_PROPERTY définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

Paramètres

[in] pPropertyList

Pointeur vers la liste de propriétés dans laquelle localiser la valeur.

[in] cbPropertyListSize

Taille, en octets, de la liste de propriétés spécifiée par pPropertyList.

[in] pszPropertyName

Pointeur vers une chaîne Unicode terminée par null contenant le nom de la propriété à localiser.

[out, optional] pbPropertyValue

Pointeur vers un pointeur BYTE vers une mémoire tampon (allouée par la fonction) contenant une copie de la valeur de la propriété. Vous devez appeler LocalFree (sur *pbPropertyValue) pour libérer la mémoire allouée. Si aucune valeur n’est requise, passez la valeur NULL pour ce paramètre.

[out, optional] pcbPropertyValueSize

Pointeur vers la taille, en octets, de la valeur retournée. Si aucune taille n’est requise, passez la valeur NULL pour ce paramètre.

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

Code de retour	Description
ERROR_INVALID_DATA	La liste de propriétés n’est pas correctement mise en forme.
ERROR_NOT_ENOUGH_MEMORY	La fonction n’a pas pu allouer de mémoire tampon dans laquelle retourner la valeur de la propriété.
ERROR_FILE_NOT_FOUND	La propriété spécifiée n’a pas pu se trouver dans la liste des propriétés.

Remarques

Si ResUtilFindBinaryProperty réussit, *pbPropertyValue pointe vers une copie des données stockées dans pPropertyList. Veillez à appeler LocalFree sur *pbPropertyValue pour éviter les fuites de mémoire.

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