Função GetAppContainerFolderPath (userenv.h)

  • Artigo

Obtém o caminho da pasta de dados do aplicativo local para o contêiner de aplicativo especificado.

Sintaxe

USERENVAPI HRESULT GetAppContainerFolderPath(
  [in]  PCWSTR pszAppContainerSid,
  [out] PWSTR  *ppszPath
);

Parâmetros

[in] pszAppContainerSid

Um ponteiro para o SID do contêiner do aplicativo.

[out] ppszPath

O endereço de um ponteiro para uma cadeia de caracteres que, quando essa função retorna com êxito, recebe o caminho da pasta local. É responsabilidade do chamador liberar essa cadeia de caracteres quando ela não for mais necessária chamando a função CoTaskMemFree .

Retornar valor

Essa função retorna um código HRESULT , incluindo, mas não se limitando ao seguinte:

Código de retorno Descrição
S_OK
 A operação foi concluída com sucesso.
E_INVALIDARG
 O parâmetro pszAppContainerSid ou ppszPath é NULL.

Comentários

O caminho recuperado por meio dessa função é o mesmo caminho que você obteria chamando a função SHGetKnownFolderPath com FOLDERID_LocalAppData.

Se um token de thread estiver definido, essa função usará o contêiner do aplicativo para o usuário atual. Se nenhum token de thread estiver definido, essa função usará o contêiner de aplicativo associado à identidade do processo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho userenv.h
Biblioteca Userenv.lib
DLL Userenv.dll

Confira também

GetAppContainerRegistryLocation