Función RpcAsyncInitializeHandle (rpcasync.h)

Artículo
03/01/2024

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