Fonction ResUtilGetResourceNameDependency (resapi.h)

Article
08/25/2023

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

Syntaxe

HRESOURCE ResUtilGetResourceNameDependency(
  [in] LPCWSTR lpszResourceName,
  [in] LPCWSTR lpszResourceType
);

Paramètres

[in] lpszResourceName

Chaîne Unicode terminée par null spécifiant le nom de la ressource dépendante. Cette ressource dépend d’une ou plusieurs ressources.

[in] lpszResourceType

Chaîne Unicode terminée par null spécifiant le type de ressource de la dépendance à retourner.

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 lpszResourceName . 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.

Notes

Les fonctions ResUtilGetResourceNameDependency, ResUtilGetResourceDependency et ResUtilGetResourceDependencyByName sont très similaires en ce qu’elles fournissent toutes l’accès aux dépendances d’un type de ressource particulier. Le tableau suivant récapitule les différences entre les fonctions.

Fonction	Comment la ressource dépendante est spécifiée	Nécessite un handle de cluster
ResUtilGetResourceDependency	Handle de ressource	Non
ResUtilGetResourceDependencyByName	Handle de ressource	Oui
ResUtilGetResourceNameDependency	Nom de la ressource	Non

N’appelez pas ResUtilGetResourceNameDependency à partir d’une fonction de point d’entrée dll de ressource. ResUtilGetResourceNameDependency peut être appelé en toute sécurité à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

Exemples

Comme l’illustre l’exemple suivant, si vous savez que la ressource A dépend d’une ressource de disque physique , vous pouvez utiliser ResUtilGetResourceNameDependency pour obtenir un handle de la dépendance.

// String initialization and error checking omitted.

HRESOURCE hResD = ResUtilGetResourceNameDependency(
                        L"Resource_A_Name",
                        L"Physical Disk" );

// Close handles and free memory.

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