Função GetDefaultCommConfigA (winbase.h)
Recupera a configuração padrão para o dispositivo de comunicações especificado.
Sintaxe
BOOL GetDefaultCommConfigA(
[in] LPCSTR lpszName,
[out] LPCOMMCONFIG lpCC,
[in, out] LPDWORD lpdwSize
);
Parâmetros
[in] lpszName
O nome do dispositivo. Por exemplo, COM1 a COM9 são portas serial e LPT1 a LPT9 são portas paralelas.
[out] lpCC
Um ponteiro para um buffer que recebe uma estrutura COMMCONFIG .
[in, out] lpdwSize
Um ponteiro para uma variável que especifica o tamanho do buffer apontado por lpCC, em bytes. Após o retorno, a variável contém o número de bytes copiados se a função for bem-sucedida ou o número de bytes necessários se o buffer for muito pequeno.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .
Comentários
Observação
O cabeçalho winbase.h define GetDefaultCommConfig 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 XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |