Fonction ResUtilSetPropertyParameterBlockEx (resapi.h)

Article
03/01/2024

Définit les propriétés dans la base de données de cluster à partir d’un bloc de paramètres.

Syntaxe

DWORD ResUtilSetPropertyParameterBlockEx(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [in]            PVOID                        Reserved,
  [in]            const LPBYTE                 pInParams,
  [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.

[in] Reserved

Réservé.

[in] pInParams

Pointeur vers un bloc de paramètres d’entrée contenant les données des propriétés décrites dans la table de propriétés pointée par pPropertyTable.

[in] pInPropertyList

Pointeur vers la mémoire tampon d’entrée contenant une liste de propriétés ou NULL. Si pInPropertyList n’a pas la valeur NULL, toutes les propriétés répertoriées dans la liste de propriétés qui ne sont pas répertoriées dans la table de propriétés sont également définies dans la base de données du cluster.

[in] cbInPropertyListSize

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

[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 recevoir des données copiées à partir du paramètre pInParams .

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_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 mise à jour.
ERROR_BAD_ARGUMENTS	Un ou plusieurs des paramètres d’entrée n’étaient pas valides.

Remarques

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

ResUtilSetPropertyParameterBlockEx 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 worker. 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

ResUtilSetPropertyParameterBlock

Partager via