in-Attribut

Das [in] -Attribut 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-attribute-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] sowie die Verwendungsattribute [string], [ignore] und [context_handle].

Typspezifizierer

Gibt einen base_type-, 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 Zeigerdeklarations-Deklarator ist mit dem in C verwendeten Zeiger-Deklarator identisch. es wird aus dem *-Designator, Modifizierern wie far und dem Qualifizierer const erstellt.

Funktionsname

Gibt den Namen der Remoteprozedur an.

parameter-attribute-list

Gibt null oder mehr Attribute an, die für den angegebenen Parametertyp geeignet sind. Parameterattribute mit dem [in] -Attribut können auch das richtungsgerichtete Attribut [out]; die Feldattribute [first_is], [last_is], [length_is], [max_is], [size_is] und [switch_type]; das Zeigerattribute [ref], [unique] oder [ptr]; und die Nutzungsattribute [context_handle] und [Zeichenfolge]. Das Verwendungsattribut [ignore] kann nicht als Parameterattribute verwendet werden. Trennen Sie mehrere Attribute durch 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 Zeiger. Der Parameterdeklarationsator im Funktionsdeklarationsator, z. B. der Parametername, ist optional.

Bemerkungen

Das [in] -Attribut verfügt über ein umgekehrtes Attribut, [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 Richtungsparameterattribute bezeichnet, da sie die Richtung angeben, in der Parameter übergeben werden. Ein Parameter kann als [in], [out] oder [in, out] definiert werden.

Das [in] -Attribut identifiziert Parameter, die vom Client-Stub für die Übertragung an den Server gemarst werden.

Das [in] -Attribut wird standardmäßig auf einen Parameter angewendet, wenn kein Attribut für den richtungsgerichteten Parameter angegeben ist.

Beispiele

HRESULT MyFunction([in] short count);

Weitere Informationen

IDL-Datei (Interface Definition)

midl_user_allocate

out