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 |
---|---|
|
Un ou plusieurs des paramètres d’entrée n’étaient pas valides. |
|
La taille de la mémoire tampon d’entrée spécifiée dans cbInPropertyListSize est trop petite. |
|
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. |
|
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 |