Fonction ResUtilGetProperties (resapi.h)

Article
08/25/2023

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 une liste de propriétés. Le type PRESUTIL_GET_PROPERTIES définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilGetProperties(
  [in]  HKEY                         hkeyClusterKey,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] PVOID                        pOutPropertyList,
  [in]  DWORD                        cbOutPropertyListSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

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écrivent les propriétés à récupérer.

[out] pOutPropertyList

Pointeur vers une mémoire tampon de sortie dans laquelle retourner la liste de propriétés.

[in] cbOutPropertyListSize

Taille en octets de la mémoire tampon de sortie pointée par pOutPropertyList.

[out] pcbBytesReturned

Pointeur vers le nombre total d’octets dans la liste de propriétés pointée par pOutPropertyList.

[out] pcbRequired

Pointeur vers le nombre d’octets requis si pOutPropertyList est trop petit.

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_MORE_DATA	La mémoire tampon de sortie était trop petite pour contenir les données résultantes. Le paramètre pcbRequired indique la taille requise.
ERROR_NOT_ENOUGH_MEMORY	Une erreur s’est produite lors de l’allocation de la mémoire.

Spécifications


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

ResUtilGetPrivateProperties

Partager via