IResourceList::FindUntranslatedEntry method (portcls.h)

Article
02/22/2024

The FindUntranslatedEntry method returns a pointer to an untranslated entry of the specified type, or NULL if no such pointer is found.

Syntax

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

Parameters

[in] Type

Identifies the resource type of the entries that are to be counted. For a list of valid values, see the Type member of the CM_PARTIAL_RESOURCE_DESCRIPTOR structure.

[in] Index

Specifies the index of the entry to find. If the IResourceList::NumberOfEntriesOfType method returns a value n for the number of entries of type Type, valid indices range from 0 to n-1. If Index is zero, for example, the method returns a pointer to the untranslated version of the first occurrence of an entry of the specified type from the resource list.

Return value

FindUntranslatedEntry returns a pointer to the specified entry or is NULL if the entry does not exist. This pointer remains valid until the resource object is deleted.

Remarks

For each resource type, a macro is defined to call this method. See IResourceList.

The Index parameter indicates which occurrence of an entry of the specified type to find in the list of translated resource entries. The first occurrence in the list has an index of zero.

For each resource type, a macro is defined to call this method. See IResourceList.

For more information about translated and untranslated (or "raw") resources, see CM_PARTIAL_RESOURCE_DESCRIPTOR.

Requirements

Requirement	Value
Target Platform	Universal
Header	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL