in (attributo)

Articolo
06/13/2023

L'attributo [in] indica che un parametro deve essere passato dalla routine chiamante alla routine chiamata.

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

Parametri

function-attribute-list: Specifica zero o più attributi che si applicano alla funzione. Gli attributi di funzione validi sono [callback], [local], l'attributo puntatore [ref], [unique]o [ ptr]e gli attributi di utilizzo [ string], [ ignore]e [ context_handle].
identificatore di tipo: Specifica un base_type, struct, unione o tipo di enumerazione o identificatore di tipo. Una specifica di archiviazione facoltativa può precedere l'identificatore di tipo.
puntatore dichiaratore: Specifica zero o più dichiaratori puntatori. Un dichiaratore puntatore è lo stesso del dichiaratore puntatore usato in C; viene costruito dal designatore *, modificatori come la lontano e il qualificatore const.
nome funzione: Specifica il nome della routine remota.
parameter-attribute-list: Specifica zero o più attributi appropriati per il tipo di parametro specificato. Gli attributi dei parametri con l'attributo [in] possono anche accettare l'attributo direzionale [out]; gli attributi del campo [first_is], [last_is], [length_is] , [max_is], [size_is ]e [switch_type]; attributo puntatore [ref], [unique]o [ptr]; e gli attributi di utilizzo [context_handle] e [string]. Impossibile usare l'attributo di utilizzo [ignore] come attributo di parametro. Separare più attributi con virgole.
Dichiaratore: Specifica i dichiaratori C standard, ad esempio identificatori, dichiaratori di puntatore e dichiaratori di matrice. Per altre informazioni, vedere Matrice e Sized-Pointer attributi, matrici e matrici e puntatori. Il dichiaratore di parametri nel dichiaratore di funzioni, ad esempio il nome del parametro, è facoltativo.

Commenti

L'attributo [in] ha un attributo al contrario, [out], che indica che un parametro deve essere restituito dalla routine chiamata alla routine chiamante. Gli attributi [in] e [out] sono noti come attributi dei parametri direzionali perché specificano la direzione in cui vengono passati i parametri. Un parametro può essere definito come [in], [out]o [in, out].

L'attributo [in] identifica i parametri che vengono marshallati dallo stub del client per la trasmissione al server.

L'attributo [in] viene applicato a un parametro per impostazione predefinita quando non viene specificato alcun attributo di parametro direzionale.

Esempi

HRESULT MyFunction([in] short count);

Vedere anche

File IDL (Interface Definition)
midl_user_allocate
Cambio