Função PathUnExpandEnvStringsA (shlwapi.h)
Substitui determinados nomes de pasta em um caminho totalmente qualificado pela cadeia de caracteres de ambiente associada.
Sintaxe
BOOL PathUnExpandEnvStringsA(
[in] LPCSTR pszPath,
[out] LPSTR pszBuf,
[in] UINT cchBuf
);
Parâmetros
[in] pszPath
Tipo: LPCTSTR
Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o caminho a ser não verificado.
[out] pszBuf
Tipo: LPTSTR
Um ponteiro para um buffer que, quando esse método retorna com êxito, recebe a cadeia de caracteres nãoexpandada. O tamanho desse buffer deve ser definido como MAX_PATH para garantir que ele seja grande o suficiente para manter a cadeia de caracteres retornada.
[in] cchBuf
Tipo: UINT
O tamanho, em caracteres, no buffer pszBuf .
Valor retornado
Tipo: BOOL
Retorna TRUE se tiver êxito; caso contrário, FALSE.
Comentários
Os caminhos de pasta a seguir são substituídos por sua cadeia de caracteres de ambiente equivalente.
Pasta | Cadeia de caracteres de ambiente |
---|---|
A pasta de perfil Todos os Usuários | %ALLUSERSPROFILE% |
A pasta de dados do aplicativo do usuário atual (somente Windows Vista e posterior). | %APPDATA% |
O nome do sistema | %COMPUTERNAME% |
A pasta Arquivos de Programas | %ProgramFiles% |
A pasta raiz do sistema | %SystemRoot% |
A letra da unidade do sistema | %SystemDrive% |
A pasta de perfil do usuário atual | %USERPROFILE% |
Observação
O cabeçalho shlwapi.h define PathUnExpandEnvStrings 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 2000 Professional, Windows XP [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 | shlwapi.h |
Biblioteca | Shlwapi.lib |
DLL | Shlwapi.dll (versão 5.0 ou posterior) |