IResourceList::FindTranslatedEntry-Methode (portcls.h)

Artikel
08/07/2023

Die FindTranslatedEntry -Methode gibt einen Zeiger auf einen übersetzten Eintrag des angegebenen Typs oder NULL zurück, wenn kein solcher Eintrag gefunden wird.

Syntax

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

Parameter

[in] Type

Gibt den Ressourcentyp des zu suchenden Eintrags an. Eine Liste der gültigen Ressourcentypwerte finden Sie im Element Typ der CM_PARTIAL_RESOURCE_DESCRIPTOR-Struktur .

[in] Index

Gibt den Index des zu suchenden Eintrags an. Wenn die IResourceList::NumberOfEntriesOfType-Methode einen Wert n für die Anzahl der Einträge vom Typ Type zurückgibt, liegen gültige Indizes zwischen 0 und n-1. Wenn Index beispielsweise null ist, gibt die Methode einen Zeiger auf die übersetzte Version des ersten Vorkommens eines Eintrags des angegebenen Typs aus der Ressourcenliste zurück.

Rückgabewert

FindTranslatedEntry gibt einen Zeiger auf den angegebenen Eintrag zurück oder ist NULL , wenn der Eintrag nicht vorhanden ist. Dieser Zeiger bleibt gültig, bis das Ressourcenlistenobjekt gelöscht wird.

Hinweise

Für jeden Ressourcentyp wird ein Makro definiert, um diese Methode aufzurufen. Siehe IResourceList.

Der Index-Parameter gibt an, welches Vorkommen eines Eintrags des angegebenen Typs in der Liste der übersetzten Ressourceneinträge gefunden werden soll. Das erste Vorkommen in der Liste weist einen Index von 0 auf.

Für jeden Ressourcentyp wird ein Makro definiert, um diese Methode aufzurufen. Siehe IResourceList.

Weitere Informationen zu übersetzten und nicht übersetzten Ressourcen (oder "Rohdaten") finden Sie unter CM_PARTIAL_RESOURCE_DESCRIPTOR.