Fonction ResUtilVerifyPropertyTable (resapi.h)

Article
03/04/2024

Utilise une table de propriétés pour vérifier qu’une liste de propriétés est correctement mise en forme.

Syntaxe

DWORD ResUtilVerifyPropertyTable(
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

Paramètres

[in] pPropertyTable

Pointeur vers une table de propriétés décrivant les propriétés qui seront validées dans la liste des propriétés.

Reserved

Ce paramètre est réservé à un usage futur.

[in] bAllowUnknownProperties

Si la valeur est TRUE, la fonction ignore toutes les propriétés de la liste de propriétés qui ne sont pas incluses dans la table de propriétés. Si la valeur est FALSE, toute propriété de la liste de propriétés qui n’est pas incluse dans la table de propriétés entraîne le retour de la fonction ERROR_INVALID_PARAMETER.

[in] pInPropertyList

Pointeur vers la mémoire tampon d’entrée contenant la liste de propriétés à valider.

[in] cbInPropertyListSize

Taille en octets de la mémoire tampon d’entrée pointée par pInPropertyList.

[out, optional] pOutParams

Pointeur vers un bloc de paramètres.

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_INSUFFICIENT_BUFFER	La mémoire tampon de liste de propriétés est supérieure à celle indiquée par le paramètre cbInPropertyListSize .
ERROR_INVALID_DATA	Aucune mémoire tampon de liste de propriétés n’a été spécifiée ou la liste de propriétés est mise en forme incorrectement
ERROR_INVALID_PARAMETER	La liste de propriétés est mise en forme incorrectement. Si bAllowUnknownProperties a la valeur FALSE, la liste de propriétés peut contenir des propriétés qui ne sont pas présentes dans la table de propriétés.

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