RPC_IF_CALLBACK_FN回调函数 (rpcdce.h)
RPC_IF_CALLBACK_FN是应用程序提供的安全回调函数的原型。 程序可以为它定义的每个接口提供回调函数。
语法
RPC_IF_CALLBACK_FN RpcIfCallbackFn;
RPC_STATUS RpcIfCallbackFn(
RPC_IF_HANDLE InterfaceUuid,
[in] void *Context
)
{...}
参数
InterfaceUuid
[in] Context
指向表示客户端的RPC_IF_ID服务器绑定句柄的指针。 在函数声明中,此类型必须为 RPC_IF_HANDLE,但它是客户端绑定句柄,可以安全地强制转换为它。 回调函数可以将此句柄传递给 RpcImpersonateClient、 RpcBindingServerFromClient、 RpcGetAuthorizationContextForClient 或任何其他接受客户端绑定句柄以获取有关客户端信息的服务器端函数。
返回值
如果允许客户端在此接口中调用方法,则回调函数应返回RPC_S_OK。 任何其他返回代码都会导致客户端收到异常RPC_S_ACCESS_DENIED。
注意 有关有效错误代码的列表,请参阅 RPC 返回值。
注解
在某些情况下,RPC 运行时可能会对每个接口的每个客户端多次调用安全回调函数。 请确保回调函数可以处理这种可能性。
安全回调必须声明为 RPC_ENTRY。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rpcdce.h (包括 Rpc.h) |