RouterCreatePrintAsyncNotificationChannel-Funktion (prnasntp.h)

Artikel
08/07/2023

Die Funktion RouterCreatePrintAsyncNotificationChannel 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 NULL-Zeichenfolge, die den Namen des Druckers oder Druckservers angibt.

[in] pNotificationType

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

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 die unidirektionale Kommunikation wirksam ist.

ppIAsynchNotification

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

Rückgabewert

RouterCreatePrintAsyncNotificationChannel gibt bei Erfolg S_OK und andernfalls einen COM-Standardfehlercode zurück.

Hinweise

In einigen Fällen müssen Sie den Kanal freigeben, den Sie mit der Funktion RouterCreatePrintAsyncNotificationChannel erstellt haben, indem Sie Release auf IPrintAsyncNotifyChannel aufrufen.

Informationen zum Freigeben eines Kanals finden Sie unter Benachrichtigungskanal.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prnasntp.h (einschließlich Prnasntp.h)
Bibliothek	Spoolss.lib
DLL	Spoolss.dll

Freigeben über