Fonction ResUtilGetPropertiesToParameterBlock (resapi.h)

Article
03/01/2024

Récupère les propriétés spécifiées par une table de propriétés à partir de la base de données de cluster et les retourne dans un bloc de paramètres.

Syntaxe

DWORD ResUtilGetPropertiesToParameterBlock(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out]           LPBYTE                       pOutParams,
  [in]            BOOL                         bCheckForRequiredProperties,
  [out, optional] LPWSTR                       *pszNameOfPropInError
);

Paramètres

[in] hkeyClusterKey

Pointeur vers la clé de base de données de cluster qui identifie l’emplacement des propriétés à récupérer.

[in] pPropertyTable

Pointeur vers un tableau de structures RESUTIL_PROPERTY_ITEM qui décrit les propriétés à traiter.

[out] pOutParams

Pointeur vers le bloc de paramètres de sortie à remplir.

[in] bCheckForRequiredProperties

Spécifie si une erreur doit être générée si les propriétés requises sont manquantes.

[out, optional] pszNameOfPropInError

Adresse du pointeur de chaîne dans lequel retourner le nom de l’erreur générée par une propriété obligatoire manquante. La propriété ppszNameOfPropInError est facultative.

Valeur retournée

Si les opérations réussissent, 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 paramètres d’entrée n’étaient pas valides.
ERROR_NOT_ENOUGH_MEMORY	Une erreur s’est produite lors de l’allocation de la mémoire.

Remarques

Avec la fonction utilitaire ResUtilGetPropertiesToParameterBlock , la table de propriétés pointée par pPropertyTable peut inclure des valeurs par défaut.

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