in (attributo)
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