Fonction RouterCreatePrintAsyncNotificationChannel (prnasntp.h)

La fonction RouterCreatePrintAsyncNotificationChannel crée un canal de notification asynchrone associé à une imprimante ou un serveur d’impression.

Syntaxe

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

Paramètres

[in] pName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’imprimante ou du serveur d’impression.

[in] pNotificationType

Pointeur vers un GUID qui représente le type de notifications envoyées via ce canal.

eNotifyFilter

Filtre pour la session ou l’utilisateur qui reçoit les notifications.

[in] eConversationStyle

Type de communication : unidirectionnel ou bidirectionnel.

[in] pCallback

Pointeur vers la fonction de rappel appelée pour remettre les notifications de réponse, lorsque la communication bidirectionnelle est appliquée. Ce paramètre est ignoré lorsque la communication unidirectionnelle est appliquée.

ppIAsynchNotification

Pointeur vers une variable qui reçoit l’adresse de l’objet interface qui représente le canal de notification.

Valeur retournée

RouterCreatePrintAsyncNotificationChannel retourne S_OK en cas de réussite et retourne un code d’erreur COM standard dans le cas contraire.

Remarques

Dans certains cas, vous devez libérer le canal que vous avez créé avec la fonction RouterCreatePrintAsyncNotificationChannel en appelant Release sur IPrintAsyncNotifyChannel.

Pour plus d’informations sur le moment où publier un canal, consultez Canal de notification.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prnasntp.h (inclure Prnasntp.h)
Bibliothèque	Spoolss.lib
DLL	Spoolss.dll