Função ComDBClaimNextFreePort (msports.h)

Artigo
03/05/2024

ComDBClaimNextFreePort retorna o menor número de porta COM que ainda não está em uso.

Sintaxe

LONG ComDBClaimNextFreePort(
  [in]  HCOMDB  HComDB,
  [out] LPDWORD ComNumber
);

Parâmetros

[in] HComDB

Manipule para o banco de dados de porta COM retornado por ComDBOpen.

[out] ComNumber

Ponteiro para o número da porta COM que a rotina retorna ao chamador. Esse ponteiro deve ser não NULL. Um número de porta é um inteiro que varia de 1 a COMDB_MAX_PORTS_ARBITRATED.

Retornar valor

ComDBClaimNextFreePort retorna um dos seguintes valores de status.

Código de retorno	Descrição
ERROR_SUCCESS	A rotina retornou com êxito um número de porta COM.
ERROR_CANTWRITE	A rotina não pôde gravar no banco de dados.
ERROR_INVALID_PARAMETER	O identificador de banco de dados de porta COM especificado não é válido.
ERROR_NO_LOG_SPACE	O banco de dados não pode arbitrar mais números de porta.
ERROR_NOT_CONNECTED	A rotina não pôde acessar o banco de dados. Para obter informações de erro estendidas, chame GetLastError.
ERROR_Xxx	Ocorreu um erro interno; chame GetLastError para obter informações de erro estendidas.

Comentários

A declaração de um número de porta COM no banco de dados da porta COM registra o número da porta como "em uso". Observe que o banco de dados não contém informações sobre o chamador ou dispositivo que declara um número de porta.

ComDBClaimNextFreePort é executado no modo de usuário.

Para obter mais informações, consulte Obtendo e liberando um número de porta COM.