Compartilhar via

Função ComDBResizeDatabase (msports.h)

  • Artigo

ComDBResizeDatabase redimensiona o banco de dados de porta COM.

Sintaxe

LONG ComDBResizeDatabase(
  [in] HCOMDB HComDB,
  [in] DWORD  NewSize
);

Parâmetros

[in] HComDB

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

[in] NewSize

Especifica um novo tamanho para o banco de dados de porta COM, em que o tamanho do banco de dados é o número de números de porta atualmente arbitrados no banco de dados. Esse valor deve ser um múltiplo inteiro de 1024, deve ser maior que o tamanho atual e deve ser menor ou igual a COMDB_MAX_PORTS_ARBITRATED.

Retornar valor

ComDBResizeDatabase retorna um dos seguintes valores de status.

Código de retorno Descrição
ERROR_SUCCESS
 O banco de dados foi redimensionado com êxito.
ERROR_BAD_LENGTH
 NewSize é menor ou igual ao tamanho do banco de dados atual ou é maior que COMDB_MAX_PORTS_ARBITRATED.
ERROR_CANTWRITE
 A rotina não pôde gravar no banco de dados.
ERROR_INVALID_PARAMETER
 Uma das opções a seguir é verdadeira: o identificador especificado para o banco de dados de porta COM não é válido. NewSize não é um múltiplo de 1024.
ERROR_NOT_CONNECTED
 A rotina não pôde acessar o banco de dados. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Use ComDBGetCurrentPortUsage para obter o tamanho atual do banco de dados.

ComDBResizeDatabase é executado no modo de usuário.

Para obter mais informações, consulte Redimensionando o banco de dados de porta COM.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho msports.h (inclua Msports.h)
Biblioteca Msports.lib
DLL Msports.dll

Confira também

ComDBGetCurrentPortUsage