IResourceList ::FindTranslatedEntry, méthode (portcls.h)

Article
02/26/2024

La FindTranslatedEntry méthode retourne un pointeur vers une entrée traduite du type spécifié, ou NULL si aucune entrée de ce type n’est trouvée.

Syntaxe

PCM_PARTIAL_RESOURCE_DESCRIPTOR FindTranslatedEntry(
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

Paramètres

[in] Type

Identifie le type de ressource de l’entrée à rechercher. Pour obtenir la liste des valeurs de type ressource valides, consultez le membre type de la structure CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Spécifie l’index de l’entrée à rechercher. Si la méthode IResourceList ::NumberOfEntriesOfType retourne une valeur n pour le nombre d’entrées de type Type, les index valides vont de 0 à n-1. Si Index est égal à zéro, par exemple, la méthode retourne un pointeur vers la version traduite de la première occurrence d’une entrée du type spécifié à partir de la liste de ressources.

Valeur retournée

FindTranslatedEntry retourne un pointeur vers l’entrée spécifiée ou a la valeur NULL si l’entrée n’existe pas. Ce pointeur reste valide jusqu’à ce que l’objet de liste de ressources soit supprimé.

Remarques

Pour chaque type de ressource, une macro est définie pour appeler cette méthode. Consultez IResourceList.

Le paramètre Index indique l’occurrence d’une entrée du type spécifié à rechercher dans la liste des entrées de ressource traduites. La première occurrence de la liste a un index de zéro.

Pour chaque type de ressource, une macro est définie pour appeler cette méthode. Consultez IResourceList.

Pour plus d’informations sur les ressources traduites et non traduites (ou « brutes »), consultez CM_PARTIAL_RESOURCE_DESCRIPTOR.