Função RpcAsyncInitializeHandle (rpcasync.h)

Artigo
08/25/2023

O cliente chama a função RpcAsyncInitializeHandle para inicializar a estrutura RPC_ASYNC_STATE a ser usada para fazer uma chamada assíncrona.

Sintaxe

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

Parâmetros

pAsync

Ponteiro para a estrutura RPC_ASYNC_STATE que contém informações de chamada assíncronas.

Size

Tamanho da estrutura RPC_ASYNC_STATE .

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_ARG	O tamanho é muito pequeno ou muito grande.
RPC_S_INVALID_ASYNC_HANDLE	pAsync aponta para memória inválida.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

O cliente cria uma nova estrutura RPC_ASYNC_STATE e um ponteiro para essa estrutura e chama RpcAsyncInitializeHandle com o ponteiro como um parâmetro de entrada. A função RpcAsyncInitializeHandle inicializa os campos que usa para manter o estado de uma chamada remota assíncrona. Quando a chamada para RpcAsyncInitializeHandle retorna com êxito, o cliente pode definir o tipo de notificação e todos os campos relacionados a esse tipo de notificação na estrutura RPC_ASYNC_STATE . O aplicativo cliente usa um ponteiro para essa estrutura para fazer uma chamada assíncrona.

O cliente não deve tentar alterar os membros Size, Signature, Lock e StubInfo da estrutura RPC_ASYNC_STATE ; Fazer isso invalidará o identificador.

Nota No Windows 2000, após a conclusão de uma chamada assíncrona, a estrutura RPC_ASYNC_STATE deve ser reinicializada antes de ser usada para outra chamada assíncrona. No Windows XP e posteriores, a estrutura RPC_ASYNC_STATE está pronta para reutilização imediata após uma chamada assíncrona concluída.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	rpcasync.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll