Compartilhar via


Função TransmitCommChar (winbase.h)

Transmite um caractere especificado à frente de quaisquer dados pendentes no buffer de saída do dispositivo de comunicações especificado.

Sintaxe

BOOL TransmitCommChar(
  [in] HANDLE hFile,
  [in] char   cChar
);

Parâmetros

[in] hFile

Um identificador para o dispositivo de comunicações. A função CreateFile retorna esse identificador.

[in] cChar

O caractere a ser transmitido.

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, chame GetLastError.

Comentários

A função TransmitCommChar é útil para enviar um caractere de interrupção (como um CTRL+C) para um sistema host.

Se o dispositivo não estiver transmitindo, TransmitCommChar não poderá ser chamado repetidamente. Depois que TransmitCommChar colocar um caractere no buffer de saída, o caractere deverá ser transmitido antes que a função possa ser chamada novamente. Se o caractere anterior ainda não tiver sido enviado, TransmitCommChar retornará um erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de comunicação

Recursos de comunicação

CreateFile

WaitCommEvent