Funzione RemovePrintDeviceObject (winsplp.h)

  • Articolo

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

Vedi anche

AddPrintDeviceObject