Funzione StartDocW (wingdi.h)

Articolo
11/20/2024

La funzione StartDoc avvia un processo di stampa.

Sintassi

int StartDocW(
  [in] HDC            hdc,
  [in] const DOCINFOW *lpdi
);

Parametri

[in] hdc

Handle per il contesto di dispositivo per il processo di stampa.

[in] lpdi

Puntatore a una struttura DOCINFO contenente il nome del file di documento e il nome del file di output.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è maggiore di zero. Questo valore è l'identificatore del processo di stampa per il documento.

Se la funzione ha esito negativo, il valore restituito è minore o uguale a zero.

Osservazioni

Nota Questa è una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime, ad esempio lo stato della rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.

Le applicazioni devono chiamare la funzione StartDoc immediatamente prima di iniziare un processo di stampa. L'uso di questa funzione garantisce che i documenti a più pagine non vengano interpersi con altri processi di stampa.

Le applicazioni possono usare il valore restituito da StartDoc per recuperare o impostare la priorità di un processo di stampa. Chiamare la funzione GetJob o SetJob e specificare questo valore come uno degli argomenti obbligatori.

Esempi

Per un programma di esempio che usa questa funzione, vedere Procedura: Stampa con l'API di stampa GDI.

Nota

L'intestazione wingdi.h definisce StartDoc come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll