in-Attribut
Das Attribut [in] gibt an, dass ein Parameter von der aufrufenden Prozedur an die aufgerufene Prozedur übergeben werden soll.
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
[ in [ , parameter-attribute-list ] ] type-specifier [declarator]
, ...);
Parameter
-
function-attribut-list
-
Gibt null oder mehr Attribute an, die für die Funktion gelten. Gültige Funktionsattribute sind [callback], [local], das Zeigerattribut [ref], [unique]oder [ptr], und die Verwendungsattribute [string], [ignore] und [context_handle].
-
Typbezeichner
-
Gibt einen base_type- oder Struktur-, Union- oder Enumerationstyp oder Typbezeichner an. Eine optionale Speicherspezifikation kann dem Typbezeichner vorangestellt werden.
-
Zeiger-Deklarator
-
Gibt null oder mehr Zeiger-Deklaratoren an. Ein Zeiger-Deklarator ist identisch mit dem Zeiger-Deklarator, der in C verwendet wird; es wird aus dem *-Designator, Modifizierern wie weit und der Qualifizierer konst konstruiert.
-
Funktionsname
-
Gibt den Namen der Remoteprozedur an.
-
parameter-attribut-list
-
Gibt null oder mehr Attribute an, die für den angegebenen Parametertyp geeignet sind. Parameterattribute mit dem Attribut [in] können auch das direktionale Attribut [out]; die Feldattribute [first_is], [last_is], [length_is], [max_is], [size_is] und [switch_type]; das Zeiger-Attribut [ref], [unique], oder [ptr]; und die Verwendungsattribute [context_handle] und [Zeichenfolge]. Das Verwendungsattribute [ignore] kann nicht als Parameterattribute verwendet werden. Trennen Sie mehrere Attribute mit Kommas.
-
declarator
-
Gibt Standard-C-Deklaratoren an, z. B. Bezeichner, Zeiger-Deklaratoren und Array-Deklaratoren. Weitere Informationen finden Sie unter Array und Sized-Pointer Attribute, Arrays und Arrays und Zeigern. Der Parameter-Deklarator im Funktionsdeklarationsator, z. B. der Parametername, ist optional.
Bemerkungen
Das Attribut [in] weist ein umgekehrtes Attribut auf, [out], das angibt, dass ein Parameter von der aufgerufenen Prozedur an die aufrufende Prozedur zurückgegeben werden soll. Die Attribute [in] und [out] werden als direktionale Parameterattribute bezeichnet, da sie die Richtung angeben, in der Parameter übergeben werden. Ein Parameter kann als [in], [out], oder [in, out] definiert werden.
Das Attribut [in] identifiziert Parameter, die vom Client-Stub zur Übertragung an den Server gemarstet werden.
Das Attribut [in] wird standardmäßig auf einen Parameter angewendet, wenn kein direktionales Parameterattribute angegeben wird.
Beispiele
HRESULT MyFunction([in] short count);
Weitere Informationen