Fonction ResUtilSetPropertyParameterBlock (resapi.h)

Article
08/25/2023

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

Syntaxe

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

[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 par pInPropertyList.

[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 paramètres d’entrée n’étaient pas valides.

Remarques

Si une valeur spécifiée dans le bloc de paramètres existe déjà dans la base de données du cluster, la valeur n’est pas écrite. Pour forcer l’écriture de toutes les valeurs, consultez ResUtilSetPropertyParameterBlockEx.

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

ResUtilSetPropertyParameterBlock 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

Partager via