атрибут implicit_handle

  • Статья

Атрибут ACF [implicit_handle] указывает дескриптор, используемый для функций, которые не включают явный дескриптор в качестве параметра процедуры.

implicit_handle(handle-type handle-name)

Параметры

тип дескриптора

Указывает тип данных дескриптора, например базовый тип handle_t или определяемый пользователем тип дескриптора.

handle-name

Указывает имя дескриптора.

Комментарии

Дескриптор, заданный атрибутом [implicit_handle] , используется различными способами в зависимости от характера процедуры. Если процедура является удаленной, дескриптор будет использоваться в качестве дескриптора привязки для удаленного вызова. Неявный дескриптор также может использоваться для установки начальной привязки для функции, которая использует дескриптор контекста. Если процедура является процедурой сериализации, дескриптор используется в качестве дескриптора сериализации, управляющего операцией. В случае сериализации типа дескриптор используется в качестве дескриптора сериализации для всех сериализованных типов.

Атрибут [implicit_handle] указывает глобальную переменную, содержащую дескриптор, используемый любой функцией, требующей неявных дескрипторов.

Тип дескриптора неявной привязки должен быть либо handle_t (или тип на основе handle_t), либо определяемый пользователем тип дескриптора, заданный атрибутом handle . Неявный дескриптор сериализации должен быть типом, основанным на handle_t.

Если тип неявного дескриптора не определен в IDL-файле или в каких-либо файлах, включенных и импортированных IDL-файлом для компьютера MIDL, при компиляции заглушки необходимо указать файл, содержащий определение типа дескриптора. Используйте инструкцию ACF include , чтобы включить файл, содержащий определение типа дескриптора.

Атрибут [implicit_handle] может возникать не более одного раза. Атрибут [implicit_handle] может возникать только в том случае, если атрибуты [auto_handle] и [explicit_handle] не встречаются.

Примеры

/* ACF file */ 
[
    implicit_handle(handle_t hMyHandle)
] 
interface iface
{ 
    // Attribute configuration statements
}

См. также раздел

Файл конфигурации приложения (ACF)

auto_handle

explicit_handle

handle_t

Включают