Fonction ResUtilGetResourceDependencyByNameEx (resapi.h)

Article
03/04/2024

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

Syntaxe

HRESOURCE ResUtilGetResourceDependencyByNameEx(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [in] BOOL     bRecurse,
  [in] DWORD    dwDesiredAccess
);

Paramètres

[in] hCluster

Handle du cluster auquel la ressource appartient.

[in] hSelf

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

[in] lpszResourceType

Chaîne Unicode terminée par null qui spécifie le type 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. Utiliser GENERIC_ALL revient à appeler ResUtilGetResourceDependencyByName.

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 responsable de la fermeture du handle en appelant CloseClusterResource.

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

Code de retour	Description
HRESOURCE
NULL	L’opération n’a pas réussi. 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 de l’utilitaire de ressources

Partager via