auto_handle 属性
[auto_handle] ACF 属性指示存根自动为没有显式绑定句柄参数的函数建立绑定。
注意
此属性已过时,不再受支持。 建议使用 /robust 开关。
[
auto_handle [, interface-attribute-list]
]
interface interface-name
{
interface-definition
}
参数
-
interface-attribute-list
-
interface-name
-
指定接口的名称。
-
interface-definition
-
指定构成接口定义的 IDL 语句。
备注
[auto_handle] 属性显示在 ACF 的接口标头中。 指定 MIDL 编译器开关 /app_config 时,它还会显示在 IDL 文件的接口标头中。
当客户端调用使用自动绑定的函数并且不存在对服务器的绑定时,存根会自动建立绑定。 该绑定将重复使用,以便后续调用接口中使用自动绑定的其他函数。 客户端应用程序无需声明或执行与绑定句柄相关的任何处理。
如果 ACF 不存在或不包含 [implicit_handle] 属性,则 MIDL 编译器使用 [auto_handle] 并发出信息性消息。 如果需要,MIDL 编译器还使用 [auto_handle]来建立 [context_handle] 的初始绑定。
[auto_handle] 属性仅当 [implicit_handle] 或 [explicit_handle] 属性未出现时才会出现。 [auto_handle] 属性最多可以在 ACF 或 IDL 接口标头中出现一次。
注意
不能对 [auto_handle] 属性使用自动绑定 (,如果通过管道处理数据,则默认) 。
示例
[
auto_handle
]
interface MyInterface
{
/* Interface definition goes here*/
}
[
auto_handle,
code
]
interface MyInterface
{
/* Interface definition goes here*/
}
另请参阅