Função OpenPort (winsplp.h)

Artigo
08/08/2023

A função OpenPort de um monitor de porta abre uma porta de impressora.

Sintaxe

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

Parâmetros

pName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que contém o nome da porta a ser aberta.

pHandle

Ponteiro fornecido pelo chamador para um local para receber um identificador de porta.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE. Caso contrário, ele deverá retornar FALSE.

Comentários

As DLLs do servidor de monitor de porta são necessárias para definir uma função OpenPort e incluir o endereço da função em uma estrutura MONITOR2 .

A função OpenPort é chamada, por um monitor de idioma ou pelo spooler de impressão, quando uma fila de impressão está sendo conectada a uma porta. A principal finalidade da função OpenPort é retornar um identificador de porta que o chamador pode usar como argumento de entrada para chamadas subsequentes para as funções StartDocPort, WritePort, ReadPort, EndDocPort e GetPrinterDataFromPort do monitor de porta.

Além de retornar um identificador de porta, a função OpenPort pode executar operações de inicialização que precisam ser cuidadas antes que as operações de leitura ou gravação sejam executadas. Por exemplo, se a porta der suporte a valores de tempo limite modificáveis, a função OpenPort deverá definir esses valores.

As chamadas para OpenPort não são específicas para o trabalho de impressão. Entre cada chamada para as funções OpenPort e ClosePort de um monitor de porta, pode haver várias chamadas para suas funções StartDocPort e EndDocPort .

Você pode supor que, depois que o spooler de impressão tiver chamado OpenPort com um nome de porta específico, ele não chamará OpenPort novamente com o mesmo nome de porta antes de chamar ClosePort.

As funções de monitor de impressão que aceitam um identificador de porta como entrada também não aceitam um identificador de monitor. Portanto, a função OpenPort deve armazenar o identificador de monitor recebido em um local que possa ser referenciado pelo identificador de porta. Isso permite que as funções que aceitam um identificador de porta referenciem o identificador do monitor.