Fonction ResUtilGetDwordProperty (resapi.h)

Article
03/13/2024

Récupère une propriété DWORD à partir d’une liste de propriétés et avance un pointeur vers la propriété suivante dans la liste. Le type PRESUTIL_GET_DWORD_PROPERTY définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilGetDwordProperty(
  [out] LPDWORD               pdwOutValue,
  [in]  const PCLUSPROP_DWORD pValueStruct,
  [in]  DWORD                 dwOldValue,
  [in]  DWORD                 dwMinimum,
  [in]  DWORD                 dwMaximum,
  [out] LPBYTE                *ppPropertyList,
  [out] LPDWORD               pcbPropertyListSize
);

Paramètres

[out] pdwOutValue

Adresse d’un pointeur dans lequel la valeur DWORD de la liste de propriétés sera retournée.

[in] pValueStruct

Pointeur vers une structure CLUSPROP_DWORD spécifiant la valeur DWORD à récupérer à partir de la liste de propriétés.

[in] dwOldValue

Spécifie la valeur précédente de la propriété .

[in] dwMinimum

Spécifie la valeur minimale autorisée pour la propriété .

[in] dwMaximum

Spécifie la valeur maximale autorisée pour la propriété .

[out] ppPropertyList

Adresse du pointeur vers la mémoire tampon de liste de propriétés contenant la propriété DWORD . Ce pointeur est avancé jusqu’au début de la propriété suivante.

[out] pcbPropertyListSize

Pointeur vers la taille de la mémoire tampon de liste de propriétés. La taille est décrémentée pour tenir compte de l’avance du pointeur ppPropertyList .

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_INVALID_PARAMETER	La mise en forme des données est incorrecte.

Remarques

La fonction utilitaire ResUtilGetDwordProperty vérifie que la valeur retournée dans pdwOutValue se trouve dans la plage spécifiée par dwMinimum et dwMaximum. Si dwMinimum et dwMaximum sont tous deux définis sur 0, aucune vérification de plage n’est effectuée.

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

ResUtilGetBinaryProperty

ResUtilGetMultiSzProperty

ResUtilGetSzProperty

Partager via