auto_handle 属性

[auto_handle] ACF 属性指示存根自动为没有显式绑定句柄参数的函数建立绑定。

注意

此属性已过时,不再受支持。 建议使用 /robust 开关。

 

[ 
    auto_handle [, interface-attribute-list] 
] 
interface interface-name
{
    interface-definition
}

参数

interface-attribute-list

指定作为一个整体应用于接口的零个或多个属性,例如 代码nocode。 用逗号分隔接口属性。

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*/
}

另请参阅

应用程序配置文件 (ACF)

/app_config

代码

explicit_handle

context_handle

implicit_handle

nocode