IResourceList::FindUntranslatedEntry-Methode (portcls.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[in] Type

Gibt den Ressourcentyp der zu zählenden Einträge an. Eine Liste der gültigen Werte 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 nicht übersetzte Version des ersten Vorkommens eines Eintrags des angegebenen Typs aus der Ressourcenliste zurück.

Rückgabewert

FindUntranslatedEntry 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 Ressourcenobjekt 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.