Função RouterCreatePrintAsyncNotificationChannel (prnasntp.h)

A função RouterCreatePrintAsyncNotificationChannel cria um canal de notificação assíncrono associado a uma impressora ou servidor de impressão.

Sintaxe

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

Parâmetros

[in] pName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da impressora ou do servidor de impressão.

[in] pNotificationType

Um ponteiro para um GUID que representa o tipo de notificações enviadas por meio desse canal.

eNotifyFilter

Um filtro para a sessão ou o usuário que recebe as notificações.

[in] eConversationStyle

O tipo de comunicação: unidirecional ou bidirecional.

[in] pCallback

Um ponteiro para a função de retorno de chamada que é chamada para entregar as notificações de resposta, quando a comunicação bidirecional está em vigor. Esse parâmetro é ignorado quando a comunicação unidirecional está em vigor.

ppIAsynchNotification

Um ponteiro para uma variável que recebe o endereço do objeto de interface que representa o canal de notificação.

Retornar valor

RouterCreatePrintAsyncNotificationChannel retorna S_OK em caso de êxito e retorna um código de erro COM padrão caso contrário.

Comentários

Em alguns casos, você deve liberar o canal que criou com a função RouterCreatePrintAsyncNotificationChannel chamando Release em IPrintAsyncNotifyChannel.

Para obter informações sobre quando liberar um canal, consulte Canal de Notificação.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	prnasntp.h (inclua Prnasntp.h)
Biblioteca	Spoolss.lib
DLL	Spoolss.dll