RouterCreatePrintAsyncNotificationChannel-Funktion (prnasntp.h)

Artikel
02/07/2025

Die RouterCreatePrintAsyncNotificationChannel Funktion erstellt einen asynchronen Benachrichtigungskanal, der einem Drucker oder Druckserver zugeordnet ist.

Syntax

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

Parameter

[in] pName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Druckers oder Druckservers angibt.

[in] pNotificationType

Ein Zeiger auf eine GUID, die den Typ der Benachrichtigungen darstellt, die über diesen Kanal gesendet werden.

eNotifyFilter

Ein Filter für die Sitzung oder den Benutzer, der die Benachrichtigungen empfängt.

[in] eConversationStyle

Die Art der Kommunikation: unidirektional oder bidirektional.

[in] pCallback

Ein Zeiger auf die Rückruffunktion, die aufgerufen wird, um die Antwortbenachrichtigungen zu übermitteln, wenn die bidirektionale Kommunikation wirksam ist. Dieser Parameter wird ignoriert, wenn eine unidirektionale Kommunikation wirksam ist.

ppIAsynchNotification

Ein Zeiger auf eine Variable, die die Adresse des Schnittstellenobjekts empfängt, das den Benachrichtigungskanal darstellt.

Rückgabewert

RouterCreatePrintAsyncNotificationChannelS_OK zurück und gibt andernfalls einen standardmäßigen COM-Fehlercode zurück.

Bemerkungen

In einigen Fällen müssen Sie den Kanal freigeben, den Sie mit der funktion RouterCreatePrintAsyncNotificationChannel erstellt haben, indem Sie Release für IPrintAsyncNotifyChannelaufrufen.

Informationen zum Freigeben eines Kanals finden Sie unter Benachrichtigungskanal.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prnasntp.h (include Prnasntp.h)
Library	Spoolss.lib
DLL-	Spoolss.dll

Freigeben über