Funzione RemovePrintDeviceObject (winsplp.h)
Avviso
A partire da Windows 10, le API che supportano provider di stampa di terze parti sono deprecate. Microsoft non consiglia alcun investimento nei provider di stampa di terze parti. Inoltre, nei Windows 8 e nei prodotti più recenti in cui è disponibile il modello di driver di stampa v4, i provider di stampa di terze parti potrebbero non creare o gestire code che usano i driver di stampa v4.
La funzione RemovePrintDeviceObject rimuove un oggetto dispositivo da una coda del provider di stampa.
Sintassi
HRESULT RemovePrintDeviceObject(
[in] HANDLE hDeviceObject
);
Parametri
[in] hDeviceObject
Handle per l'oggetto dispositivo da rimuovere. Questo deve essere un oggetto dispositivo creato con AddPrintDeviceObject.
Valore restituito
La funzione RemovePrintDeviceObject restituisce S_OK, se l'oggetto dispositivo è stato rimosso correttamente. In caso contrario, restituisce un errore.
Ad esempio, questa funzione può restituire HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), se è stato usato un handle dell'oggetto dispositivo non valido per chiamare la funzione. Si noti che, indipendentemente dal valore restituito, l'handle dell'oggetto dispositivo non è valido dopo il completamento di una chiamata a RemovePrintDeviceObject .
Commenti
Chiamare RemovePrintDeviceObject per rimuovere l'oggetto dispositivo per una stampante eliminata. Quando i servizi spooler si arrestano, tutti gli oggetti dispositivo vengono eliminati automaticamente, quindi non è necessario chiamare RemovePrintDeviceObject per ogni oggetto dispositivo stampante.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winsplp.h (includere Winspool.h) |
| Libreria | WinSpool.lib |
| DLL | WinSpool.drv |