Função ComDBReleasePort (msports.h)

ComDBReleasePort libera um número de porta COM no banco de dados de porta COM.

Sintaxe

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

[in] HComDB

Identificador para o banco de dados de porta COM que foi retornado pelo ComDBOpen.

[in] ComNumber

Especifica o número da porta COM a ser liberado. Um número de porta é um inteiro que varia de um a COMDB_MAX_PORTS_ARBITRATED.

ComDBReleasePort retorna um dos seguintes valores de status.

Código de retorno	Descrição
ERROR_SUCCESS	O número da porta COM foi liberado.
ERROR_CANTWRITE	A rotina não pôde gravar no banco de dados.
ERROR_INVALID_PARAMETER	Uma das seguintes opções é true: o identificador especificado para o banco de dados de porta COM não é válido. O número da porta especificado não está no banco de dados de porta COM.
ERROR_NOT_CONNECTED	A rotina não pôde acessar o banco de dados. Para obter informações de erro estendidas, chame GetLastError.

Liberar um número de porta COM significa registrar o número da porta como "não em uso".

ComDBReleasePort é executado no modo de usuário.