CeFindAllFiles (RAPI)

9/8/2008

Essa função recupera informações sobre todos os arquivos e diretórios o Diretório determinado de armazenar o objeto Windows Embedded CE em um remoto dispositivo.

Syntax

BOOL CeFindAllFiles(
  LPCWSTR szPath, 
  DWORD dwFlags, 
  LPDWORD lpdwFoundCount, 
  LPLPCE_FIND_DATA ppFindDataArray 
);

Parameters

• szPath
  [no] Seqüência de caracteres NULL-Terminated contém o nome do caminho de pesquisa para arquivos. Observe que em seqüência de caracteres o caminho, duas barras invertidas (\) devem ser usadas para alcançar uma barra invertida única, pois a linguagem C reserva uma única barra invertida para caracteres de escape. De exemplo, um válido caminho seria "\\temp", enquanto um caminho definido como "\temp" Seria expansão para o caractere de tabulação seguido por "Emp".

• dwFlags
  [no] Combinação de filtro e sinalizadores de recuperação. O filtro sinalizadores especificar quais tipos de arquivos para documento e a recuperação sinalizadores especificar quais membros das CE_FIND_DATA estrutura para recuperar.

  Os sinalizadores filtro podem ser uma combinação do seguinte valores.

  Valor	Descrição
  FAF_ATTRIB_CHILDREN	SOMENTE informações recuperar para pastas que possuem itens filho.
  FAF_ATTRIB_NO_HIDDEN	Fazer não recuperar informações para arquivos ou pastas que possuem o atributo oculto definido.
  FAF_FOLDERS_ONLY	SOMENTE informações recuperar para diretórios.
  FAF_NO_HIDDEN_SYS_ROMMODULES	Fazer não recuperar informações para ROM arquivos ou pastas.
  FAF_GETTARGET	Obtenha informações destino atalho.

  Os sinalizadores de recuperação podem ser uma combinação do seguinte valores.

  Valor	Descrição
  FAF_ATTRIBUTES	Recuperar o arquivo atributos e copiá-los para o dwFileAttributes membro.
  FAF_CREATION_TIME	Recuperar o arquivo hora da criação e copiá-lo para o ftCreationTime membro.
  FAF_LASTACCESS_TIME	Recuperar o tempo quando o arquivo foi acessado pela última vez e copiá-lo para o ftLastAccessTime membro.
  FAF_LASTWRITE_TIME	Recuperar o tempo quando o arquivo foi gravado pela última vez para e copiá-lo para o ftLastWriteTime membro.
  FAF_SIZE_HIGH	Recuperar o alto-ordem DWORD valor do arquivo tamanho e copiá-lo para o nFileSizeHigh membro.
  FAF_SIZE_LOW	Recuperar o baixo-ordem DWORD valor do arquivo tamanho e copiá-lo para o nFileSizeLow membro.
  FAF_OID	Recuperar o identificador de arquivo e copiar objeto-lo para o dwOID membro.
  FAF_NAME	Recuperar o nome arquivo e copiá-lo para o cFileName membro.
  FAF_FLAG_COUNT	Contagem de sinalizadores. Apenas para uso interno.

• lpdwFoundCount
  [out] Ponteiro longo para uma variável que recebe uma contagem dos itens encontrados.

• ppFindDataArray
  [out] Ponteiro para o ponteiro para uma matriz de CE_FIND_DATA estruturas que receberam informações sobre os itens encontrados. É responsabilidade do aplicativo para a memória usada pela matriz livre. A livre a memória é necessário chamar CeRapiFreeBuffer.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions