Funzione OpenPort (winsplp.h)

Articolo
03/05/2024

La funzione OpenPort di un monitor delle porte apre una porta della stampante.

Sintassi

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

Parametri

pName

Puntatore fornito dal chiamante a una stringa contenente il nome della porta da aprire.

pHandle

Puntatore fornito dal chiamante a una posizione per ricevere un handle di porta.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve restituire FALSE.

Commenti

Le DLL del server di monitoraggio delle porte sono necessarie per definire una funzione OpenPort e includere l'indirizzo della funzione in una struttura MONITOR2 .

La funzione OpenPort viene chiamata, da un monitoraggio del linguaggio o dallo spooler di stampa, quando una coda di stampa è connessa a una porta. Lo scopo principale della funzione OpenPort è restituire un handle di porta che il chiamante può usare come argomento di input per le chiamate successive alle funzioni StartDocPort, WritePort, ReadPort, EndDocPort e GetPrinterDataFromPort del monitor della porta.

Oltre a restituire un handle di porta, la funzione OpenPort può eseguire operazioni di inizializzazione che devono essere prese in considerazione prima di eseguire operazioni di lettura o scrittura. Ad esempio, se la porta supporta valori di timeout modificabili, la funzione OpenPort deve impostare questi valori.

Le chiamate a OpenPort non sono specifiche del processo di stampa. Tra ogni chiamata alle funzioni OpenPort e ClosePort di un monitor della porta, possono essere presenti più chiamate alle funzioni StartDocPort e EndDocPort .

È possibile presupporre che dopo che lo spooler di stampa abbia chiamato OpenPort con un nome di porta specifico, non chiamerà nuovamente OpenPort con lo stesso nome di porta prima di chiamare ClosePort.

Le funzioni di monitoraggio di stampa che accettano un handle di porta come input non accettano anche un handle di monitoraggio. Pertanto, la funzione OpenPort deve archiviare l'handle di monitoraggio ricevuto in un percorso a cui è possibile fare riferimento dall'handle di porta. In questo modo le funzioni che accettano un handle di porta per fare riferimento all'handle di monitoraggio.