Função SHGetSpecialFolderPathA (shlobj_core.h)

[NÃO há suporte para SHGetSpecialFolderPath . Em vez disso, use SHGetFolderPath.]

Recupera o caminho de uma pasta especial, identificada por seu CSIDL.

Sintaxe

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR pszPath,
  [in]  int   csidl,
  [in]  BOOL  fCreate
);

Parâmetros

hwnd

Digite: HWND

Reservado.

[out] pszPath

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que recebe a unidade e o caminho da pasta especificada. Esse buffer deve ter pelo menos MAX_PATH caracteres de tamanho.

[in] csidl

Tipo: int

Um CSIDL que identifica a pasta de interesse. Se uma pasta virtual for especificada, essa função falhará.

[in] fCreate

Tipo: BOOL

Indica se a pasta deve ser criada se ela ainda não existir. Se esse valor não for zero, a pasta será criada. Se esse valor for zero, a pasta não será criada.

Retornar valor

Tipo: BOOL

TRUE se tiver êxito; caso contrário, FALSE.

Comentários

A Atualização da Área de Trabalho do Microsoft Internet Explorer 4.0 deve ser instalada para que essa função esteja disponível.

Observação

O cabeçalho shlobj_core.h define SHGetSpecialFolderPath como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 4.71 ou posterior)