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.

Requisitos