SHGetSpecialFolderPath

9/9/2008

Essa função recupera o caminho de uma pasta especial, identificada por sua CSIDL.

Syntax

BOOL SHGetSpecialFolderPath(
  HWND hwndOwner,
  LPTSTR lpszPath,
  int nFolder,
  BOOL fCreate 
);

Parameters

• hwndOwner
  [no] Identificador para o janela proprietária o cliente deve especificar se ele exibe uma caixa diálogo ou mensagem caixa.

• lpszPath
  [no] Endereço de reserva um caractere que recebe a unidade e caminho da pasta especificada. Esta reserva deve ter pelo menos caracteres MAX_PATH em tamanho.

• nFolder
  [no] Valor especificando a pasta para qual recuperar a localidade. A seguinte tabela mostra os valores possíveis. **Para obter informações específicas suporte Windows Mobile, consulte o Comentários seção. **

  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.
  CSIDL_CONTROLS	Não suportado.
  CSIDL_DESKTOP	Diretório sistema de arquivo usado para armazenar objetos arquivo fisicamente no área de trabalho.
  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.
  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_MYMUSIC	Pasta que contém os arquivos de música.
  CSIDL_MYPICTURES	Pasta que contém arquivos de imagem.
  CSIDL_MYVIDEO	Pasta que contém vídeo arquivos.
  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.
  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 Iniciar Itens de menu.
  CSIDL_STARTUP	Diretório sistema de arquivo que corresponde ao 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.

• fCreate
  [no] Indica se a pasta deve ser criada se ela já não existir. Se esse valor é diferente de zero, a pasta é criada. Se esse valor for zero, a pasta não será criada.

Return Value

No padrão shell, essa função retorna TRUE se ele for bem-sucedido e FALSE se ele falhar.

Se você estiver usando as extensões AYGShell, essa função retorna FALSE mesmo bem-sucedido. Se a pasta representada pela CSIDL não existe e não é criada, um NULL seqüência de caracteres é retornado indicando que o Diretório não existe.

Observação

Windows Mobile 2003 e posterior, retorna TRUE se bem-sucedido, FALSE caso contrário.Pocket PC 2002 e Smartphone 2002 e versões anteriores, retorna FALSE mesmo bem-sucedido.Se a pasta representada pela nFolder parâmetro não existe e não é criado, um NULL seqüência de caracteres é retornado indicando que o Diretório não existe.

Remarks

Para todas as plataformas

Um número de pastas é usado freqüentes por aplicativos, mas não podem ter o mesmo nome ou localidade em qualquer sistema determinado. Valores CSIDL fornecem um exclusivo System-Independent para identificar essas pastas especiais. Os valores substitui o uso de variáveis ambiente para essa finalidade.

Para Windows incorporado CE

Para Windows Embedded CE Um CSIDL é usado em conjunto com a função shell SHGetSpecialFolderLocation Para recuperar caminho nome ou item identificação lista de uma pasta especial (PIDL). Consulte SHGetSpecialFolderLocation Para uma lista de válido valores CSIDL. **

Para Mobile Windows

Para Windows Mobile a seguinte tabela lista suporte para valores CSIDL para a nFolder parâmetro:

Valor	Descrição
CSIDL_BITBUCKET	Não suportado.
CSIDL_DESKTOPDIRECTORY	Não suportado.
CSIDL_MYMUSIC	Suporte somente para dispositivos Windows Mobile powered.
CSIDL_MYPICTURES	Suporte somente para dispositivos Windows Mobile powered.
CSIDL_MYVIDEO	Suporte somente para dispositivos Windows Mobile powered.
CSIDL_NETWORK	Não suportado.
CSIDL_PROFILE	Não suportado.
CSIDL_RECENT	Não suportado.

Requirements

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