Função OpenPort (winsplp.h)
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.
Valor de retorno
Se a operação for bem-sucedida, a função deverá retornar VERDADEIRO. Caso contrário, ele deverá retornar FALSE.
Observações
As DLLs do servidor do monitor de porta são necessárias para definir uma função OpenPort e incluir o endereço da função em uma estrutura de 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. O objetivo principal da função OpenPort é retornar um identificador de porta que o chamador pode usar como argumento de entrada para chamadas subsequentes ao StartDocPort, WritePort, ReadPort, EndDocPorte funções GetPrinterDataFromPort.
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 do trabalho de impressão. Entre cada chamada para as funções OpenPort de um monitor de porta e ClosePort, 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 façam referência ao identificador do monitor.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | NtosKrnl.exe |