Função GetAppContainerFolderPath (userenv.h)
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 |
---|---|
|
A operação foi concluída com sucesso. |
|
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 |