атрибут auto_handle

  • Статья

Атрибут ACF [auto_handle] направляет заглушку автоматически установить привязку для функции, которая не имеет явного параметра binding-handle.

Примечание

Этот атрибут устарел и больше не поддерживается. Рекомендуется использовать параметр /robust .

 

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

Параметры

interface-attribute-list

Указывает ноль или более атрибутов, которые применяются к интерфейсу в целом, например код или nocode. Разделяйте атрибуты интерфейса запятыми.

interface-name

Указывает имя интерфейса.

определение интерфейса

Задает операторы IDL, которые формируют определение интерфейса.

Комментарии

Атрибут [auto_handle] отображается в заголовке интерфейса ACF. Он также отображается в заголовке интерфейса IDL-файла при указании параметра компилятора MIDL /app_config.

Когда клиент вызывает функцию, которая использует автоматическую привязку и привязка к серверу не существует, заглушка автоматически устанавливает привязку. Привязка повторно используется для последующих вызовов других функций в интерфейсе, использующих автоматическую привязку. Клиентской программе приложения не нужно объявлять или выполнять обработку, связанную с дескриптором привязки.

Если 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