RpcAsyncInitializeHandle 函数 (rpcasync.h)

项目
03/01/2024

客户端调用 RpcAsyncInitializeHandle 函数来初始化要用于进行异步调用的 RPC_ASYNC_STATE 结构。

语法

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

参数

pAsync

指向包含异步调用信息的 RPC_ASYNC_STATE 结构的指针。

Size

RPC_ASYNC_STATE结构的大小。

返回值

值	含义
RPC_S_OK	调用成功。
RPC_S_INVALID_ARG	大小太小或太大。
RPC_S_INVALID_ASYNC_HANDLE	pAsync 指向无效的内存。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

注解

客户端创建新的 RPC_ASYNC_STATE 结构和指向该结构的指针，并使用指针作为输入参数调用 RpcAsyncInitializeHandle 。 RpcAsyncInitializeHandle 函数初始化用于维护异步远程调用状态的字段。当对 RpcAsyncInitializeHandle 的调用成功返回时，客户端可以在 RPC_ASYNC_STATE 结构中设置通知类型以及与该通知类型相关的任何字段。客户端应用程序使用指向此结构的指针进行异步调用。

客户端不应尝试更改 RPC_ASYNC_STATE 结构的 Size、Signature、Lock 和 StubInfo 成员;这样做会使句柄失效。

注意在 Windows 2000 中，异步调用完成后，必须先重新初始化 RPC_ASYNC_STATE 结构，然后再用于另一个异步调用。在 Windows XP 及更高版本中， RPC_ASYNC_STATE 结构可在完成异步调用后立即重复使用。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	rpcasync.h (包括 Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll