Partager via


Fonction ResUtilSetPropertyTableEx (resapi.h)

Définit les propriétés de 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 ResUtilSetPropertyTableEx(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [in]            BOOL                         bForceWrite,
  [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.

[in] bForceWrite

Force l’écriture des valeurs de propriété dans la base de données du cluster même si les nouvelles valeurs sont identiques aux valeurs existantes

[out, optional] pOutParams

Pointeur vers un bloc de paramètres pour contenir les données retournées. Lorsque ce pointeur est spécifié, seuls les paramètres qui diffèrent de ceux de la mémoire tampon d’entrée sont écrits dans le 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_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

N’appelez pas ResUtilSetPropertyTableEx à partir des fonctions de point d’entrée de la DLL de ressource suivantes :

ResUtilSetPropertyTableEx 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

ResUtilSetPropertyTable