Función RpcAsyncInitializeHandle (rpcasync.h)

El cliente llama a la función RpcAsyncInitializeHandle para inicializar la estructura de RPC_ASYNC_STATE que se usará para realizar una llamada asincrónica.

Sintaxis

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

Parámetros

pAsync

Puntero a la estructura RPC_ASYNC_STATE que contiene información de llamada asincrónica.

Size

Tamaño de la estructura RPC_ASYNC_STATE .

Valor devuelto

Valor Significado
RPC_S_OK
La llamada se realizó correctamente.
RPC_S_INVALID_ARG
El tamaño es demasiado pequeño o demasiado grande.
RPC_S_INVALID_ASYNC_HANDLE
pAsync apunta a memoria no válida.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

El cliente crea una nueva estructura de RPC_ASYNC_STATE y un puntero a esa estructura y llama a RpcAsyncInitializeHandle con el puntero como parámetro de entrada. La función RpcAsyncInitializeHandle inicializa los campos que usa para mantener el estado de una llamada remota asincrónica. Cuando la llamada a RpcAsyncInitializeHandle se devuelve correctamente, el cliente puede establecer el tipo de notificación y los campos relacionados con ese tipo de notificación en la estructura RPC_ASYNC_STATE . La aplicación cliente usa un puntero a esta estructura para realizar una llamada asincrónica.

El cliente no debe intentar modificar los miembros Size, Signature, Lock y StubInfo de la estructura RPC_ASYNC_STATE ; si lo hace, invalidará el identificador.

Nota En Windows 2000, una vez completada una llamada asincrónica, la estructura RPC_ASYNC_STATE debe reinicializarse antes de usarse para otra llamada asincrónica. En Windows XP y versiones posteriores, la estructura de RPC_ASYNC_STATE está lista para volver a usar inmediatamente después de una llamada asincrónica completada.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcasync.h (incluir Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RPC asincrónico

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcServerTestCancel