Função GetSystemDirectoryA (sysinfoapi.h)
Recupera o caminho do diretório do sistema. O diretório do sistema contém arquivos do sistema, como bibliotecas de vínculo dinâmico e drivers.
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 GetSystemDirectoryA(
[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 sistema seja o diretório raiz. Por exemplo, se o diretório do sistema for chamado Windows\System32 na unidade C, o caminho do diretório do sistema recuperado por essa função será C:\Windows\System32.
[in] uSize
O tamanho máximo do buffer, em TCHARs.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será o comprimento, em TCHARs, da cadeia de caracteres copiada para o buffer, 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, incluindo o caractere nulo de encerramento.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Os aplicativos não devem criar arquivos no diretório do sistema. Se o usuário estiver executando uma versão compartilhada do sistema operacional, o aplicativo não terá acesso de gravação ao diretório do sistema.
Exemplos
Para obter um exemplo, consulte Obtendo informações do sistema.
Nota
O cabeçalho sysinfoapi.h define GetSystemDirectory 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 [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | sysinfoapi.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |