Fonction ResUtilGetResourceDependencyByClassEx (resapi.h)

Article
03/01/2024

Énumère les dépendances d’une ressource spécifiée dans un cluster spécifié et retourne un handle à une dépendance qui correspond à une classe de ressource spécifiée. Le type PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_CLASS_EX définit un pointeur vers cette fonction.

Syntaxe

HRESOURCE ResUtilGetResourceDependencyByClassEx(
  [in] HCLUSTER                  hCluster,
  [in] HANDLE                    hSelf,
  [in] PCLUS_RESOURCE_CLASS_INFO prci,
  [in] BOOL                      bRecurse,
  [in] DWORD                     dwDesiredAccess
);

Paramètres

[in] hCluster

Handle du cluster auquel appartient la ressource.

[in] hSelf

Handle de la ressource dépendante. Cette ressource dépend d’une ou plusieurs ressources.

[in] prci

Pointeur vers une structure PCLUS_RESOURCE_CLASS_INFO qui décrit la classe de ressource de la dépendance à retourner.

[in] bRecurse

Détermine l’étendue de la recherche. Si la valeur est TRUE, la fonction vérifie l’arborescence de dépendances entière sous la ressource dépendante. Si la valeur est FALSE, la fonction vérifie uniquement les ressources dont dépend directement la ressource dépendante.

[in] dwDesiredAccess

Privilèges d’accès demandés. Il peut s’agir d’une combinaison de GENERIC_READ (0x80000000), de GENERIC_ALL (0x10000000) ou de MAXIMUM_ALLOWED (0x02000000). Si cette valeur est égale à zéro (0), une erreur non définie peut être retournée. L’utilisation de GENERIC_ALL revient à appeler ResUtilGetResourceDependencyByClass.

Valeur retournée

Si l’opération réussit, la fonction retourne un handle à l’une des ressources dont dépend la ressource spécifiée par hSelf . L’appelant est chargé de fermer le handle en appelant CloseClusterResource.

Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations, appelez la fonction GetLastError .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll

Voir aussi

Fonctions utilitaires de ressources

Partager via