CeGetSpecialFolderPath (RAPI)

9/8/2008

Essa função recupera o caminho para uma pasta especial shell em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

DWORD CeGetSpecialFolderPath( 
  Int nFolder, 
  DWORD nBufferLength, 
  LPWSTR lpBuffer 
);

Parameters

• nFolder
  [no] Valor especificando a pasta shell especial desejar. Este valor pode ser uma do seguinte símbolos definidos no arquivo de cabeçalho ShlObj.h.

  Valor	Descrição
  CSIDL_APPDATA	Arquivo sistema Diretório que serve como um comum repositório para dados Application-specific.
  CSIDL_BITBUCKET	Diretório sistema de arquivo que contém objetos arquivo na Lixeira do usuário. A localidade deste Diretório não está no Registro; Ele está marcado com os atributos ocultos e sistema para evitar o usuário mova ou excluí-lo. Não válido para Windows CE 5.0 e posterior.
  CSIDL_CONTROLS	Não suportado.
  CSIDL_DESKTOP	Pasta virtual que contém o área de trabalho itens. Essa é a pasta na raiz do espaço para nome virtual.
  CSIDL_DESKTOPDIRECTORY	Diretório sistema de arquivo usado para armazenar objetos arquivo fisicamente no área de trabalho (não deve ser confundida com o área de trabalho pasta próprio).
  CSIDL_DRIVES	Meu computador, que é uma pasta virtual que contém tudo sobre o local computador: armazenamento Dispositivos e impressoras. A pasta também pode conter unidades mapeadas rede. Não válido para Windows CE 5.0 e posterior.
  CSIDL_FAVORITES	Arquivo sistema Diretório que serve como um comum repositório para favorito do usuário itens.
  CSIDL_FONTS	Pasta virtual que contém as fontes.
  CSIDL_NETHOOD	Não suportado.
  CSIDL_NETWORK	Rede pasta ambiente, que é uma pasta virtual que representa o parte superior nível da hierarquia de rede. Não válido para Windows CE 5.0 e posterior.
  CSIDL_PERSONAL	Arquivo sistema Diretório que serve como um comum repositório para documentos.
  CSIDL_PRINTERS	Não suportado.
  CSIDL_PROFILE	Pasta que contém o perfil do usuário.
  CSIDL_PROGRAM_FILES	Pasta Arquivos programa.
  CSIDL_PROGRAMS	Diretório sistema de Arquivo que Contém programa grupos do usuário (que também são diretórios sistema de arquivos).
  CSIDL_RECENT	Diretório sistema de arquivo que contém documentos usado recentemente do usuário.
  CSIDL_SENDTO	Não suportado.
  CSIDL_STARTMENU	Diretório sistema de arquivo que contém os itens do menu Iniciar.
  CSIDL_STARTUP	Arquivo sistema Diretório que corrsponds para GRUPO programa de inicialização do usuário. O sistema inicia esses programas quando um dispositivo está ligado.
  CSIDL_TEMPLATES	Não suportado.
  CSIDL_WINDOWS	Pasta do Windows.

• nBufferLength
  [no] Tamanho de lpBuffer em caracteres.

• lpBuffer
  [out] Ponteiro longo para a reserva para caminho de pasta.

Return Value

O comprimento do seqüência de caracteres retornado indica sucesso. FALSE indica um relacionado RAPI falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError.

Observação

Não presuma que SHGetSpecialFolderPath define o último erro na falha.

Requirements

Header	rapi.h, shlobj.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

Other Resources