Funzione GetSpoolFileHandle

La funzione GetSpoolFileHandle recupera un handle per il file di spool associato al processo attualmente inviato dall'applicazione.

Sintassi

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

Parametri

hPrinter [in]

Handle alla stampante a cui è stato inviato il processo. Questo deve essere lo stesso handle usato per inviare il processo. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle stampante.

Valore restituito

Se la funzione ha esito positivo, restituisce un handle al file di spool.

Se la funzione ha esito negativo, restituisce INVALID_HANDLE_VALUE.

Commenti

Con l'handle al file di spool, l'applicazione può scrivere nel file di spool con chiamate a WriteFile seguito da CommitSpoolData.

L'applicazione non deve chiamare ClosePrinter in hPrinter fino a quando non ha eseguito l'accesso al file di spool per l'ultima volta. Dovrebbe quindi chiamare CloseSpoolFileHandle seguito da ClosePrinter. I tentativi di accesso all'handle di file spool dopo la chiusura dell'hPrinter originale avranno esito negativo anche se l'handle file stesso non è stato chiuso. CloseSpoolFileHandle avrà esito negativo se ClosePrinter viene chiamato prima.

Questa funzione avrà esito negativo se viene chiamata prima che il processo di stampa abbia completato il spooling.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	WinSpool.drv
Nomi Unicode e ANSI	GetSpoolFileHandleW (Unicode) e GetSpoolFileHandleA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

OpenPrinter

Addprinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData