Fonction ResUtilGetPrivateProperties (resapi.h)

Article
08/25/2023

Retourne des propriétés privées pour un objet de cluster. Le type PRESUTIL_GET_PRIVATE_PROPERTIES définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilGetPrivateProperties(
  [in]  HKEY    hkeyClusterKey,
  [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 privées à récupérer.

[out] pOutPropertyList

Pointeur vers une mémoire tampon de sortie dans laquelle une liste de propriétés avec les noms et les valeurs des propriétés privées est retournée.

[in] cbOutPropertyListSize

Taille de la mémoire tampon de sortie pointée vers 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 pour contenir toutes les propriétés privées.

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.
ERROR_MORE_DATA	La taille de la mémoire tampon de sortie est trop petite pour contenir les données résultantes. Le paramètre pcbRequired pointe vers la taille correcte.

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

ResUtilGetProperties

Partager via