Função SHGetFolderPathAndSubDirW (shlobj_core.h)

Obtém o caminho de uma pasta e acrescenta um caminho de subpasta fornecido pelo usuário.

Sintaxe

HRESULT SHGetFolderPathAndSubDirW(
  [in]  HWND    hwnd,
  [in]  int     csidl,
  [in]  HANDLE  hToken,
  [in]  DWORD   dwFlags,
  [in]  LPCWSTR pszSubDir,
  [out] LPWSTR  pszPath
);

Parâmetros

[in] hwnd

Digite: HWND

Reservado.

[in] csidl

Tipo: int

Um valor CSIDL que identifica a pasta cujo caminho deve ser recuperado. Somente pastas reais são válidas. Se uma pasta virtual for especificada, essa função falhará. Você pode forçar a criação de uma pasta com SHGetFolderPathAndSubDir combinando o CSIDL da pasta com CSIDL_FLAG_CREATE.

[in] hToken

Tipo: HANDLE

Um token de acesso que representa um usuário específico. Para sistemas anteriores ao Windows 2000, defina esse valor como NULL. Para sistemas posteriores, o hToken geralmente é, mas nem sempre, definido como NULL. Talvez seja necessário atribuir um valor ao hToken para as pastas que podem ter vários usuários, mas que são tratadas como pertencentes a um único usuário. A pasta mais usada desse tipo é Meus Documentos.

[in] dwFlags

Tipo: DWORD

Especifica se o caminho a ser retornado é o caminho real da pasta ou o caminho padrão. Esse valor é usado nos casos em que a pasta associada a um valor CSIDL pode ser movida ou renomeada pelo usuário.

SHGFP_TYPE_CURRENT

Retornar o caminho atual da pasta.

SHGFP_TYPE_DEFAULT

Retornar o caminho padrão da pasta.

[in] pszSubDir

Tipo: LPCTSTR

Um ponteiro para o subcaminho a ser acrescentado ao caminho da pasta. Essa é uma cadeia de caracteres terminada em nulo de comprimento MAX_PATH. Se você não estiver criando um novo diretório, esse deverá ser um subdiretório existente ou a função retornará um erro. Esse valor poderá ser NULL se nenhum subcaminho for acrescentado.

[out] pszPath

Tipo: LPTSTR

Quando essa função retorna, esse valor aponta para o caminho do diretório e o subcaminho acrescentado. Essa é uma cadeia de caracteres terminada em nulo de comprimento MAX_PATH. Essa cadeia de caracteres fica vazia quando a função retorna um código de erro.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Observação

O cabeçalho shlobj_core.h define SHGetFolderPathAndSubDir 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

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [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 5.60 ou posterior)

Confira também

SHGetFolderPath