Fonction ResUtilSetPropertyTable (resapi.h)

Article
03/01/2024

Définit les propriétés dans la base de données de cluster en fonction d’une liste de propriétés d’une table de propriétés..

Syntaxe

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [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] hkeyClusterKey

Clé de base de données de cluster identifiant l’emplacement des propriétés à définir.

[in] pPropertyTable

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

Reserved

Réservé.

[in] bAllowUnknownProperties

Indique si les propriétés inconnues doivent être acceptées. Ce paramètre est défini sur TRUE s’ils doivent être acceptés, et FALSE si ce n’est pas le cas.

[in] pInPropertyList

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

[in] cbInPropertyListSize

Taille en octets de la mémoire tampon d’entrée pointée vers cbInPropertyList.

[out, optional] pOutParams

Pointeur vers un bloc de paramètres pour contenir les données retournées. S’ils sont spécifiés, les paramètres sont écrits uniquement s’ils diffèrent de ceux de la mémoire tampon d’entrée.

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_INSUFFICIENT_BUFFER	La taille de la mémoire tampon d’entrée spécifiée dans cbInPropertyListSize est trop petite.
ERROR_INVALID_DATA	La mémoire tampon d’entrée pointée par pInPropertyList est NULL, un nom de propriété n’est pas valide ou une valeur de propriété est trop petite.
ERROR_INVALID_PARAMETER	La syntaxe, le format ou le type d’une propriété dans la table de propriétés pointée par pPropertyTable est incorrect ou une propriété est en lecture seule et ne peut pas être définie.

Remarques

Si une valeur spécifiée dans la table de propriétés existe déjà dans la base de données du cluster, la valeur n’est pas écrite. Pour plus d’informations sur l’écriture forcée de toutes les valeurs, consultez ResUtilSetPropertyTableEx.

N’appelez pas ResUtilSetPropertyTable à partir des fonctions de point d’entrée dll de ressource suivantes.

ResUtilSetPropertyTable peut être appelé en toute sécurité à partir de n’importe quelle autre fonction de point d’entrée dll de ressource ou à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

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

ResUtilSetPropertyTableEx

Partager via