Funzione SetForm

La funzione SetForm imposta le informazioni sul modulo per la stampante specificata.

Sintassi

BOOL SetForm(
  _In_ HANDLE hPrinter,
  _In_ LPTSTR pFormName,
  _In_ DWORD  Level,
  _In_ LPTSTR pForm
);

Parametri

hPrinter [in]

Handle per la stampante per cui sono impostate le informazioni sul modulo. Utilizzare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.

pFormName [in]

Puntatore a una stringa con terminazione Null che specifica il nome del modulo per il quale vengono impostate le informazioni sul modulo.

Livello [in]

Versione della struttura a cui punta pForm . Questo valore deve essere 1 o 2.

pForm [in]

Puntatore a una struttura FORM_INFO_1 o FORM_INFO_2 .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

SetForm può essere chiamato più volte per un FORM_INFO_2 esistente, ogni chiamata aggiunge coppie aggiuntive di valori pDisplayName e wLangId . Tutte le versioni delle lingue del modulo otterranno i valori Size e ImageableArea del FORM_INFO_2 nella chiamata più recente a SetForm.

Se il chiamante è remoto e level è 2, il valore StringTypedell'FORM_INFO_2 non può essere STRING_MUIDLL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	SetFormW (Unicode) e SetFormA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

GetForm

OpenPrinter

FORM_INFO_1

FORM_INFO_2