Enumeração ShellSpecialFolderConstants (shldisp.h)

Especifica valores exclusivos independentes do sistema que identificam pastas especiais. Essas pastas são frequentemente usadas por aplicativos, mas que podem não ter o mesmo nome ou local em um determinado sistema. Por exemplo, a pasta do sistema pode ser "C:\Windows" em um sistema e "C:\Winnt" em outro.

Syntax

typedef enum ShellSpecialFolderConstants {
  ssfDESKTOP = 0,
  ssfPROGRAMS = 0x2,
  ssfCONTROLS = 0x3,
  ssfPRINTERS = 0x4,
  ssfPERSONAL = 0x5,
  ssfFAVORITES = 0x6,
  ssfSTARTUP = 0x7,
  ssfRECENT = 0x8,
  ssfSENDTO = 0x9,
  ssfBITBUCKET = 0xa,
  ssfSTARTMENU = 0xb,
  ssfDESKTOPDIRECTORY = 0x10,
  ssfDRIVES = 0x11,
  ssfNETWORK = 0x12,
  ssfNETHOOD = 0x13,
  ssfFONTS = 0x14,
  ssfTEMPLATES = 0x15,
  ssfCOMMONSTARTMENU = 0x16,
  ssfCOMMONPROGRAMS = 0x17,
  ssfCOMMONSTARTUP = 0x18,
  ssfCOMMONDESKTOPDIR = 0x19,
  ssfAPPDATA = 0x1a,
  ssfPRINTHOOD = 0x1b,
  ssfLOCALAPPDATA = 0x1c,
  ssfALTSTARTUP = 0x1d,
  ssfCOMMONALTSTARTUP = 0x1e,
  ssfCOMMONFAVORITES = 0x1f,
  ssfINTERNETCACHE = 0x20,
  ssfCOOKIES = 0x21,
  ssfHISTORY = 0x22,
  ssfCOMMONAPPDATA = 0x23,
  ssfWINDOWS = 0x24,
  ssfSYSTEM = 0x25,
  ssfPROGRAMFILES = 0x26,
  ssfMYPICTURES = 0x27,
  ssfPROFILE = 0x28,
  ssfSYSTEMx86 = 0x29,
  ssfPROGRAMFILESx86 = 0x30
} ;

Constantes

ssfDESKTOP Valor: 0 0x00 (0). Área de trabalho do Windows – a pasta virtual que é a raiz do namespace.
ssfPROGRAMS Valor: 0x2 0x02 (2). Diretório do sistema de arquivos que contém os grupos de programas do usuário (que também são diretórios do sistema de arquivos). Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs.
ssfCONTROLS Valor: 0x3 0x03 (3). Pasta virtual que contém ícones para os aplicativos Painel de Controle.
ssfPRINTERS Valor: 0x4 0x04 (4). Pasta virtual que contém impressoras instaladas.
ssfPERSONAL Valor: 0x5 0x05 (5). Diretório do sistema de arquivos que serve como um repositório comum para documentos de um usuário. Um caminho típico é C:\Users\username\Documents.
ssfFAVORITES Valor: 0x6 0x06 (6). Diretório do sistema de arquivos que serve como um repositório comum para as URLs favoritas do usuário. Um caminho típico é C:\Documents and Settings\username\Favorites.
ssfSTARTUP Valor: 0x7 0x07 (7). Diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização do usuário. O sistema inicia esses programas sempre que qualquer usuário faz logon primeiro em seu perfil após uma reinicialização. Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\StartUp.
ssfRECENT Valor: 0x8 0x08 (8). Diretório do sistema de arquivos que contém os documentos usados mais recentemente pelo usuário. Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Recent.
ssfSENDTO Valor: 0x9 0x09 (9). Diretório do sistema de arquivos que contém itens de menu Enviar para . Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\SendTo.
ssfBITBUCKET Valor: 0xa 0x0a (10). Pasta virtual que contém os objetos na Lixeira do usuário.
ssfSTARTMENU Valor: 0xb 0x0b (11). Diretório do sistema de arquivos que contém itens de menu Iniciar . Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Menu Iniciar.
ssfDESKTOPDIRECTORY Valor: 0x10 0x10 (16). Diretório do sistema de arquivos usado para armazenar fisicamente os objetos de arquivo exibidos na área de trabalho. Não deve ser confundido com a pasta da área de trabalho em si, que é uma pasta virtual. Um caminho típico é C:\Documents and Settings\username\Desktop.
ssfDRIVES Valor: 0x11 0x11 (17). Meu Computador — a pasta virtual que contém tudo no computador local: dispositivos de armazenamento, impressoras e Painel de Controle. Essa pasta também pode conter unidades de rede mapeadas.
ssfNETWORK Valor: 0x12 0x12 (18). Network Neighborhood – a pasta virtual que representa a raiz da hierarquia de namespace de rede.
ssfNETHOOD Valor: 0x13 0x13 (19). Uma pasta do sistema de arquivos que contém objetos de link na pasta virtual Minha Rede Places. Não é o mesmo que ssfNETWORK, que representa a raiz do namespace de rede. Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Network Shortcuts.
ssfFONTS Valor: 0x14 0x14 (20). Pasta virtual que contém fontes instaladas. Um caminho típico é C:\Windows\Fonts.
ssfTEMPLATES Valor: 0x15 0x15 (21). Diretório do sistema de arquivos que serve como um repositório comum para modelos de documento.
ssfCOMMONSTARTMENU Valor: 0x16 0x16 (22). Diretório do sistema de arquivos que contém os programas e pastas que aparecem no menu Iniciar para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu. Válido somente para sistemas Windows NT.
ssfCOMMONPROGRAMS Valor: 0x17 0x17 (23). Diretório do sistema de arquivos que contém os diretórios dos grupos de programas comuns que aparecem no menu Iniciar para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Start Menu\Programs. Válido somente para sistemas Windows NT.
ssfCOMMONSTARTUP Valor: 0x18 0x18 (24). Diretório do sistema de arquivos que contém os programas que aparecem na pasta Inicialização para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Microsoft\Windows\Start Menu\Programs\StartUp. Válido somente para sistemas Windows NT.
ssfCOMMONDESKTOPDIR Valor: 0x19 0x19 (25). Diretório do sistema de arquivos que contém arquivos e pastas que aparecem na área de trabalho para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Desktop. Válido somente para sistemas Windows NT.
ssfAPPDATA Valor: 0x1a 0x1a (26). Versão 4.71. Diretório do sistema de arquivos que serve como um repositório comum para dados específicos do aplicativo. Um caminho típico é C:\Documents and Settings\username\Application Data.
ssfPRINTHOOD Valor: 0x1b 0x1b (27). Diretório do sistema de arquivos que contém objetos de link na pasta virtual Printers. Um caminho típico é C:\Users\username\AppData\Roaming\Microsoft\Windows\Printer Shortcuts.
ssfLOCALAPPDATA Valor: 0x1c 0x1c (28). Versão 5.0. Diretório do sistema de arquivos que serve como um repositório de dados para aplicativos locais (não móveis). Um caminho típico é C:\Users\username\AppData\Local.
ssfALTSTARTUP Valor: 0x1d 0x1d (29). Diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização não localizado do usuário.
ssfCOMMONALTSTARTUP Valor: 0x1e 0x1e (30). Diretório do sistema de arquivos que corresponde ao grupo de programas de inicialização não localizado para todos os usuários. Válido somente para sistemas de Windows NT.
ssfCOMMONFAVORITES Valor: 0x1f 0x1f (31). Diretório do sistema de arquivos que serve como um repositório comum para as URLs favoritas compartilhadas por todos os usuários. Válido somente para sistemas de Windows NT.
ssfINTERNETCACHE Valor: 0x20 0x20 (32). Diretório do sistema de arquivos que serve como um repositório comum para arquivos temporários da Internet. Um caminho típico é C:\Users\username\AppData\Local\Microsoft\Windows\Temporary Internet Files.
ssfCOOKIES Valor: 0x21 0x21 (33). Diretório do sistema de arquivos que serve como um repositório comum para cookies da Internet. Um caminho típico é C:\Documents and Settings\username\Application Data\Microsoft\Windows\Cookies.
ssfHISTORY Valor: 0x22 0x22 (34). Diretório do sistema de arquivos que serve como um repositório comum para itens de histórico da Internet.
ssfCOMMONAPPDATA Valor: 0x23 0x23 (35). Versão 5.0. Dados do aplicativo para todos os usuários. Um caminho típico é C:\Documents and Settings\All Users\Application Data.
ssfWINDOWS Valor: 0x24 0x24 (36). Versão 5.0. Diretório do Windows. Isso corresponde às variáveis de ambiente %windir% ou %SystemRoot%. Um caminho típico é C:\Windows.
ssfSYSTEM Valor: 0x25 0x25 (37). Versão 5.0. A pasta Sistema. Um caminho típico é C:\Windows\System32.
ssfPROGRAMFILES Valor: 0x26 0x26 (38). Versão 5.0. Pasta Arquivos de Programas. Um caminho típico é C:\Arquivos de Programas.
ssfMYPICTURES Valor: 0x27 0x27 (39). Pasta Minhas Imagens. Um caminho típico é C:\Users\username\Pictures.
ssfPROFILE Valor: 0x28 0x28 (40). Versão 5.0. Pasta de perfil do usuário.
ssfSYSTEMx86 Valor: 0x29 0x29 (41). Versão 5.0. Pasta do sistema. Um caminho típico é C:\Windows\System32 ou C:\Windows\Syswow32 em um computador de 64 bits.
ssfPROGRAMFILESx86 Valor: 0x30 Não use esse campo. Use o valor 0x2a (42) em seu código para especificar a pasta Arquivos de Programas (x86). Um caminho típico é C:\Arquivos de Programas ou C:\Arquivos de Programas (x86) em um computador de 64 bits. Nota: No cabeçalho shldisp.h, o campo ssfPROGRAMFILESx86 é atribuído erroneamente ao valor 0x30 (48). Esse valor especifica a pasta para a pasta Ferramentas Administrativas em vez da pasta Arquivos de Programas.

Comentários

Os valores nessa enumeração são equivalentes aos respectivos valores CSIDL ou KNOWNFOLDERID correspondentes, usados em aplicativos C++. Eles substituem o uso de variáveis de ambiente para essa finalidade. Observe que nem todos os valores CSIDL ou KNOWNFOLDERID têm um valor equivalente em ShellSpecialFolderConstants.

Observação

Quando uma constante identifica uma pasta do sistema de arquivos, um caminho comumente usado é fornecido como um exemplo. No entanto, não há garantia de que esse caminho será usado em qualquer sistema específico.

Requisitos

Requisito	Valor
Cabeçalho	shldisp.h

Confira também

CSIDL

KNOWNFOLDERID