атрибут 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
}
См. также раздел