Funzione RouterCreatePrintAsyncNotificationChannel (prnasntp.h)

La funzione RouterCreatePrintAsyncNotificationChannel crea un canale di notifica asincrono associato a una stampante o a un server di stampa.

Sintassi

HRESULT RouterCreatePrintAsyncNotificationChannel(
  [in] PCWSTR                            pName,
  [in] PrintAsyncNotificationType        *pNotificationType,
       PrintAsyncNotifyUserFilter        eNotifyFilter,
  [in] PrintAsyncNotifyConversationStyle eConversationStyle,
  [in] IPrintAsyncNotifyCallback         *pCallback,
       IPrintAsyncNotifyChannel          **ppIAsynchNotification
);

Parametri

[in] pName

Puntatore a una stringa con terminazione Null che specifica il nome della stampante o del server di stampa.

[in] pNotificationType

Puntatore a un GUID che rappresenta il tipo di notifiche inviate tramite questo canale.

eNotifyFilter

Filtro per la sessione o l'utente che riceve le notifiche.

[in] eConversationStyle

Tipo di comunicazione: unidirezionale o bidirezionale.

[in] pCallback

Puntatore alla funzione di callback chiamata per recapitare le notifiche di risposta, quando è attiva la comunicazione bidirezionale. Questo parametro viene ignorato quando è attiva la comunicazione unidirezionale.

ppIAsynchNotification

Puntatore a una variabile che riceve l'indirizzo dell'oggetto interfaccia che rappresenta il canale di notifica.

Valore restituito

RouterCreatePrintAsyncNotificationChannel restituisce S_OK in caso di esito positivo e restituisce un codice di errore COM standard in caso contrario.

Commenti

In alcuni casi, è necessario rilasciare il canale creato con la funzione RouterCreatePrintAsyncNotificationChannel chiamando Release on IPrintAsyncNotifyChannel.

Per informazioni su quando rilasciare un canale, vedere Canale di notifica.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	prnasntp.h (include Prnasntp.h)
Libreria	Spoolss.lib
DLL	Spoolss.dll