Função GetSystemWindowsDirectoryA (sysinfoapi.h)
Recupera o caminho do diretório compartilhado do Windows em um sistema multiusuário.
Essa função é fornecida principalmente para compatibilidade. Os aplicativos devem armazenar código na pasta Arquivos de Programas e dados persistentes na pasta Dados do Aplicativo no perfil do usuário. Para obter mais informações, consulte ShGetFolderPath.
Sintaxe
UINT GetSystemWindowsDirectoryA(
[out] LPSTR lpBuffer,
[in] UINT uSize
);
Parâmetros
[out] lpBuffer
Um ponteiro para o buffer para receber o caminho. Esse caminho não termina com uma barra invertida, a menos que o diretório do Windows seja o diretório raiz. Por exemplo, se o diretório do Windows for nomeado Windows na unidade C, o caminho do diretório do Windows recuperado por essa função será C:\Windows. Se o sistema foi instalado no diretório raiz da unidade C, o caminho recuperado será C:.
[in] uSize
O tamanho máximo do buffer especificado pelo parâmetro lpBuffer , em TCHARs.
Retornar valor
Se a função for bem-sucedida, o valor retornado será o comprimento da cadeia de caracteres copiada para o buffer, em TCHARs, sem incluir o caractere nulo de terminação.
Se o comprimento for maior que o tamanho do buffer, o valor retornado será o tamanho do buffer necessário para manter o caminho.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Em um sistema que executa os Serviços de Terminal, cada usuário tem um diretório exclusivo do Windows. O diretório do Windows do sistema é compartilhado por todos os usuários, portanto, é o diretório em que um aplicativo deve armazenar a inicialização e os arquivos de ajuda que se aplicam a todos os usuários.
Com os Serviços de Terminal, a função GetSystemWindowsDirectory recupera o caminho do diretório windows do sistema, enquanto a função GetWindowsDirectory recupera o caminho de um diretório do Windows que é privado para cada usuário. Em um sistema de usuário único, GetSystemWindowsDirectory é o mesmo que GetWindowsDirectory.
Observação
O cabeçalho sysinfoapi.h define GetSystemWindowsDirectory 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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [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 | sysinfoapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |