Função RouterCreatePrintAsyncNotificationChannel (prnasntp.h)

Artigo
02/07/2025

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 esse 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 fornecer 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.

Valor de retorno

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

Observações

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

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prnasntp.h (inclua Prnasntp.h)
biblioteca	Spoolss.lib
de DLL	Spoolss.dll

Compartilhar via