in - атрибут

Атрибут [in] указывает, что параметр должен быть передан из вызывающей процедуры в вызываемую процедуру.

[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
    [ in [ , parameter-attribute-list ] ] type-specifier [declarator]
    , ...);

Параметры

function-attribute-list

Указывает ноль или несколько атрибутов, применяемых к функции. Допустимые атрибуты функции: [callback], [local], атрибут указателя [ref], [unique] или [ptr] и атрибуты использования [string], [ignore] и [context_handle].

type-specifier

Указывает base_type, структуру, объединение, тип перечисления или идентификатор типа. Необязательная спецификация хранилища может предшествовать описательу типа.

указатель-декларатор

Указывает ноль или несколько деклараторов указателей. Декларатор указателя совпадает с декларатором указателя, используемым в C; он создается из конструктора *, модификаторов, таких как far, и const квалификатора.

function-name

Указывает имя удаленной процедуры.

parameter-attribute-list

Указывает ноль или более атрибутов, подходящих для указанного типа параметра. Атрибуты параметра с атрибутом [in] также могут принимать атрибут направления [out]; атрибуты полей [first_is], [last_is], [length_is], [max_is], [size_is] и [switch_type]; атрибут указателя [ref], [unique], или [ptr]; и атрибуты использования [context_handle] и [строка]. Атрибут использования [ignore] нельзя использовать в качестве атрибута параметра. Разделяйте несколько атрибутов запятыми.

declarator

Задает стандартные деклараторы C, такие как идентификаторы, деклараторы указателей и деклараторы массива. Дополнительные сведения см. в разделе Атрибуты массива и Sized-Pointer, массивы и массивы и указатели. Декларатор параметров в деклараторе функции, например имя параметра, является необязательным.

Комментарии

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

Атрибут [in] определяет параметры, маршалированные клиентской заглушки для передачи на сервер.

Атрибут [in] применяется к параметру по умолчанию, если атрибут направленного параметра не указан.

Примеры

HRESULT MyFunction([in] short count);

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

Файл определения интерфейса (IDL)

midl_user_allocate

out