rpcasync.h 标头

远程过程调用 (RPC) 使用此标头。 有关详细信息，请参阅：

• 远程过程调用 (RPC)

rpcasync.h 包含以下编程接口：

函数

I_RpcExceptionFilter 确定异常是致命的还是非致命的
RpcAsyncAbortCall 服务器调用 RpcAsyncAbortCall 以中止异步调用。
RpcAsyncCancelCall 客户端调用 RpcAsyncCancelCall 函数以取消异步调用。
RpcAsyncCompleteCall 客户端和服务器调用 RpcAsyncCompleteCall 函数以完成异步远程过程调用。
RpcAsyncGetCallHandle RpcAsyncGetCallHandle 宏返回异步远程过程调用上的绑定句柄。
RpcAsyncGetCallStatus 客户端调用 RpcAsyncGetCallStatus 函数来确定异步远程调用的当前状态。
RpcAsyncInitializeHandle 客户端调用 RpcAsyncInitializeHandle 函数来初始化要用于进行异步调用的 RPC_ASYNC_STATE 结构。
RpcAsyncRegisterInfo RpcAsyncRegisterInfo 函数已过时。
RpcBindingBind RpcBindingBind 函数与 RPC 服务器联系并绑定到该服务器。
RpcBindingUnbind 取消绑定以前由 RpcBindingBind 绑定的绑定句柄。
RpcErrorAddRecord RpcErrorAddRecord 函数将扩展错误信息添加到扩展错误信息记录链中。
RpcErrorClearInformation RpcErrorClearInformation 函数清除当前线程上的所有扩展错误信息。
RpcErrorEndEnumeration RpcErrorEndEnumeration 函数结束扩展错误信息的枚举，并释放 RPC 为枚举分配的所有资源。
RpcErrorGetNextRecord RpcErrorGetNextRecord 函数检索枚举句柄的下一个扩展错误信息记录。
RpcErrorGetNumberOfRecords RpcErrorGetNumberOfRecords 函数返回扩展错误信息中的记录数。
RpcErrorLoadErrorInfo RpcErrorLoadErrorInfo 函数将调用 RpcErrorSaveErrorInfo 获取的 BLOB 转换为扩展的错误信息。
RpcErrorResetEnumeration RpcErrorResetEnumeration 函数重置任何进程内枚举的枚举游标，重置进程，以便对 RpcErrorGetNextRecord 的后续调用检索第一个扩展的错误信息记录。
RpcErrorSaveErrorInfo RpcErrorSaveErrorInfo 函数以 BLOB 的形式返回枚举句柄的所有错误信息。
RpcErrorStartEnumeration RpcErrorStartEnumeration 函数开始枚举扩展的错误信息。
RpcFreeAuthorizationContext RpcFreeAuthorizationContext 函数释放先前调用 RpcGetAuthorizationContextForClient 函数获取的 Authz 上下文。
RpcGetAuthorizationContextForClient RpcGetAuthorizationContextForClient 函数返回 RPC 客户端的 Authz 上下文，该上下文可与 Authz 函数一起使用以进行高性能身份验证。 仅支持 ncalrpc 和 ncacn_* 协议序列。
RpcServerInqCallAttributesA RpcServerInqCallAttributes 函数是获取客户端安全上下文属性的 RPC 服务器调用。 (ANSI)
RpcServerInqCallAttributesW RpcServerInqCallAttributes 函数是获取客户端安全上下文属性的 RPC 服务器调用。 (Unicode)
RpcServerSubscribeForNotification 为服务器订阅 RPC 通知。
RpcServerUnsubscribeForNotification 从 RPC 通知中取消订阅服务器。
RpcSsContextLockExclusive RpcSsContextLockExclusive 函数使应用程序能够在独占模式下开始使用上下文句柄。
RpcSsContextLockShared RpcSsContextLockShared 函数使应用程序能够在共享模式下开始使用上下文句柄。

回调函数

RPCNOTIFICATION_ROUTINE RPCNOTIFICATION_ROUTINE 函数为利用异步 RPC 的程序提供了自定义异步事件的响应的功能。

结构

RPC_ASYNC_NOTIFICATION_INFO 包含异步远程过程调用的通知信息。 可以为 I/O 完成端口配置此通知信息， (IOC) 、Windows 异步过程调用 (APC) 、Windows 消息传送和 Windows 事件通知。
RPC_ASYNC_STATE RPC_ASYNC_STATE 结构保存异步远程过程调用的状态。 RPC_ASYNC_STATE是此结构的句柄，用于等待、查询、回复或取消异步调用。
RPC_CALL_ATTRIBUTES_V1_A RPC_CALL_ATTRIBUTES_V1 结构为 RpcServerInqCallAttributes 函数提供参数。 在适用于 Windows XP 和 Windows Server 2003 操作系统的 ANSI 和 UNICODE 版本中实现。 (ANSI)
RPC_CALL_ATTRIBUTES_V1_W RPC_CALL_ATTRIBUTES_V1 结构为 RpcServerInqCallAttributes 函数提供参数。 在适用于 Windows XP 和 Windows Server 2003 操作系统的 ANSI 和 UNICODE 版本中实现。 (Unicode)
RPC_CALL_ATTRIBUTES_V2_A RPC_CALL_ATTRIBUTES_V2 结构为 RpcServerInqCallAttributes 函数提供参数。 版本 2 指定对本地地址和客户端进程 ID 的支持。 (ANSI)
RPC_CALL_ATTRIBUTES_V2_W RPC_CALL_ATTRIBUTES_V2 结构为 RpcServerInqCallAttributes 函数提供参数。 版本 2 指定对本地地址和客户端进程 ID 的支持。 (Unicode)
RPC_CALL_LOCAL_ADDRESS_V1 包含有关进行呼叫的本地地址的信息。
RPC_EE_INFO_PARAM RPC_EE_INFO_PARAM 结构用于存储扩展的错误信息。
RPC_ERROR_ENUM_HANDLE RPC_ERROR_ENUM_HANDLE 结构提供 RpcError* 函数用于处理扩展错误信息的枚举句柄。
RPC_EXTENDED_ERROR_INFO RPC_EXTENDED_ERROR_INFO 结构用于存储扩展的错误信息。

枚举

RPC_ASYNC_EVENT RPC_ASYNC_EVENT枚举类型描述 RPC 应用程序可以接收的异步通知事件。
RPC_NOTIFICATION_TYPES RPC_NOTIFICATION_TYPES枚举类型包含的值指定客户端程序将使用的异步通知方法。
RPC_NOTIFICATIONS RPC_NOTIFICATIONS枚举指定服务器可以从 RPC 接收的通知。
RpcCallClientLocality 指定可能的 RPC 客户端位置集。
RpcCallType 指定 RPC 调用类型的集。
RpcLocalAddressFormat 指定 RPC 支持的可能本地 IP 地址格式。