Fonction ResUtilFindDwordProperty (resapi.h)

Article
08/25/2023

Recherche une valeur de propriété longue non signée dans une liste de propriétés. Le type PRESUTIL_FIND_DWORD_PROPERTY définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilFindDwordProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPDWORD     pdwPropertyValue
);

Paramètres

[in] pPropertyList

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

[in] cbPropertyListSize

Taille en octets des données incluses dans pPropertyList.

[in] pszPropertyName

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

[out] pdwPropertyValue

Pointeur vers la valeur réelle des données stockées dans la mémoire tampon de liste de propriétés.

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	Les données sont dans un format incorrect.
ERROR_FILE_NOT_FOUND	La propriété n’a pas pu se trouver dans la liste des propriétés.

Notes

Si l’opération réussit, pdwPropertyValue pointe directement dans la mémoire tampon de liste de propriétés. Veillez à ne pas perturber la mise en forme de la liste de propriétés lors de l’utilisation de pdwPropertyValue.

Spécifications


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