união RPC_ASYNC_NOTIFICATION_INFO (rpcasync.h)
A união RPC_ASYNC_NOTIFICATION_INFO contém informações de notificação para chamadas de procedimento remoto assíncronas. Essas informações de notificação podem ser configuradas para IOC (portas de conclusão de E/S), APC (chamadas de procedimento assíncrono) do Windows, mensagens do Windows e notificação de eventos do Windows.
Sintaxe
typedef union _RPC_ASYNC_NOTIFICATION_INFO {
struct {
PFN_RPCNOTIFICATION_ROUTINE NotificationRoutine;
HANDLE hThread;
} APC;
struct {
HANDLE hIOPort;
DWORD dwNumberOfBytesTransferred;
DWORD_PTR dwCompletionKey;
LPOVERLAPPED lpOverlapped;
} IOC;
struct {
HWND hWnd;
UINT Msg;
} HWND;
HANDLE hEvent;
PKEVENT Event;
PFN_RPCNOTIFICATION_ROUTINE NotificationRoutine;
} RPC_ASYNC_NOTIFICATION_INFO, *PRPC_ASYNC_NOTIFICATION_INFO;
Membros
APC
Estrutura usada para notificações de APC (chamada de procedimento assíncrono) do Windows.
APC.NotificationRoutine
Chama a rotina de notificação de APC definida pelo usuário.
APC.hThread
Manipule para o thread no qual a APC de notificação deve ser postada. Um valor zero indica o thread atual.
IOC
Estrutura usada para notificação em uma porta de conclusão de E/S.
IOC.hIOPort
Identificador para a porta de conclusão de E/S.
IOC.dwNumberOfBytesTransferred
Definido pelo cliente RPC antes que a chamada assíncrona seja iniciada. Quando a notificação é entregue à porta de conclusão, esse valor é preenchido no local apontado pelo parâmetro lpNumberOfBytesTransferred da função GetQueuedCompletionStatus .
IOC.dwCompletionKey
Definido pelo cliente RPC antes que a chamada assíncrona seja iniciada. Quando a notificação é entregue à porta de conclusão, esse valor é preenchido no local apontado pelo parâmetro lpCompletionKey da função GetQueuedCompletionStatus .
IOC.lpOverlapped
Definido pelo cliente RPC antes que a chamada assíncrona seja iniciada. Quando a notificação é entregue à porta de conclusão, esse valor é preenchido no local apontado pelo parâmetro lpOverlapped da função GetQueuedCompletionStatus .
HWND
Campos usados para notificação por uma mensagem do Windows. Quando o tempo de execução do RPC posta a mensagem, wParam é zero e lParam aponta para o identificador assíncrono para a chamada (o RPC_ASYNC_STATE).
Windows Server 2003 ou posterior: A notificação por meio do HWND foi preterida. Não use este membro.
HWND.hWnd
Identifica a janela na qual a mensagem deve ser postada.
HWND.Msg
Mensagem a ser postada.
hEvent
Identificador usado para notificação por um evento.
Event
NotificationRoutine
Windows Vista ou versões anteriores do Windows: COM usa isso internamente para retornos de chamada diretos. Não use este membro.
Windows 7 ou versões posteriores do Windows: um ponteiro de função opcional para um esquema de notificação definido pelo usuário criado com base na conclusão da chamada RPC. Por exemplo, um aplicativo pode chamar SubmitThreadpoolWork do retorno de chamada de notificação.
Comentários
Antes do Windows Vista e versões anteriores do Windows, a união de RPC_ASYNC_NOTIFICATION_INFO fazia parte da estrutura RPC_ASYNC_STATE . Consulte o tópico RPC_ASYNC_STATE para obter informações adicionais.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Cabeçalho | rpcasync.h (inclua Rpc.h) |