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 denominado 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.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será o comprimento da cadeia de caracteres copiada para o buffer, em TCHARs, não incluindo 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.
Observações
Em um sistema que está executando 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 arquivos de inicialização e ajuda que se aplicam a todos os usuários.
Com os Serviços de Terminal, a função GetSystemWindowsDirectory
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | sysinfoapi.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |