RpcAsyncInitializeHandle 函数 (rpcasync.h)
客户端调用 RpcAsyncInitializeHandle 函数来初始化要用于进行异步调用 的 RPC_ASYNC_STATE 结构。
语法
RPC_STATUS RpcAsyncInitializeHandle(
PRPC_ASYNC_STATE pAsync,
unsigned int Size
);
参数
pAsync
指向包含异步调用信息的 RPC_ASYNC_STATE 结构的指针。
Size
RPC_ASYNC_STATE结构的大小。
返回值
| 值 | 含义 |
|---|---|
|
调用成功。 |
|
大小太小或太大。 |
|
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 |