Função DPA_Search (dpa_dsa.h)

  • Artigo

[DPA_Search está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Localiza um item em uma DPA (matriz de ponteiro dinâmico).

Sintaxe

int DPA_Search(
  HDPA         hdpa,
  void         *pFind,
  int          iStart,
  PFNDACOMPARE pfnCompare,
  LPARAM       lParam,
  UINT         options
);

Parâmetros

hdpa

Tipo: HDPA

Um identificador para um DPA.

pFind

Tipo: void*

Um ponteiro a ser pesquisado.

iStart

Tipo: int

O índice no qual iniciar a pesquisa.

pfnCompare

Tipo: PFNDPACOMPARE

Um ponteiro de função de comparação. Consulte PFNDPACOMPARE para ver o protótipo da função de comparação.

lParam

Tipo: LPARAM

Um parâmetro adicional a ser passado para pfnCmp.

options

Tipo: UINT

Esse parâmetro pode ser um ou mais dos seguintes.

Valor Significado
DPAS_SORTED
 Indica que o DPA está classificado.
DPAS_INSERTBEFORE
 Esse valor só é válido em conjunto com DPAS_SORTED. Se o item não for encontrado, retorne a posição em que o item deverá ser encontrado no DPA classificado.
DPAS_INSERTAFTER
 Esse valor só é válido em conjunto com DPAS_SORTED. Se o item não for encontrado, retorne a posição em que o item deverá ser encontrado no DPA classificado.

Retornar valor

Tipo: int

Retorna o índice em que o item foi encontrado no DPA ou -1 se o item não foi encontrado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dpa_dsa.h
Biblioteca Comctl32.lib
DLL ComCtl32.dll
Conjunto de APIs ext-ms-win-shell-comctl32-da-l1-1-0 (introduzido no Windows 10, versão 10.0.14393)