Método IResourceList::FindTranslatedEntry (portcls.h)

Artigo
08/07/2023

O FindTranslatedEntry método retorna um ponteiro para uma entrada traduzida do tipo especificado ou NULL se nenhuma entrada desse tipo for encontrada.

Sintaxe

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

Parâmetros

[in] Type

Identifica o tipo de recurso da entrada a ser encontrada. Para obter uma lista de valores válidos do tipo de recurso, consulte o membro Tipo da estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Especifica o índice da entrada a ser encontrada. Se o método IResourceList::NumberOfEntriesOfType retornar um valor n para o número de entradas do tipo Type, os índices válidos variam de 0 a n-1. Se Index for zero, por exemplo, o método retornará um ponteiro para a versão traduzida da primeira ocorrência de uma entrada do tipo especificado da lista de recursos.

Retornar valor

FindTranslatedEntry retorna um ponteiro para a entrada especificada ou é NULL se a entrada não existir. Esse ponteiro permanece válido até que o objeto da lista de recursos seja excluído.

Comentários

Para cada tipo de recurso, uma macro é definida para chamar esse método. Consulte IResourceList.

O parâmetro Index indica qual ocorrência de uma entrada do tipo especificado a ser encontrada na lista de entradas de recursos traduzidas. A primeira ocorrência na lista tem um índice de zero.

Para cada tipo de recurso, uma macro é definida para chamar esse método. Consulte IResourceList.

Para obter mais informações sobre recursos traduzidos e não traduzidos (ou "brutos"), consulte CM_PARTIAL_RESOURCE_DESCRIPTOR.