nocode-Attribut
Das [nocode] -Attribut wird in ACF-Headern oder mit einzelnen Funktionen verwendet, um die Generierung von Clientstubcode zu verhindern.
[
nocode
[ , ACF-interface-attributes ]
]
interface interface-name
{
[ include filename-list ; ]
[ typedef [type-attribute-list] typename; ]
[ [ nocode [ , ACF-function-attributes ] ] function-name (
[ ACF-parameter-attributes ] parameter-name ;
...);
]
...
}
Parameter
-
ACF-schnittstellenattribute
-
Gibt eine Liste mit einem oder mehreren Attributen an, die für die Schnittstelle als Ganzes gelten. Gültige Attribute sind entweder [auto_handle] oder [implicit_handle] und entweder [Code] oder [nocode]. Wenn zwei oder mehr Schnittstellenattribute vorhanden sind, müssen sie durch Kommas getrennt werden.
-
Schnittstellenname
-
Gibt den Namen der Schnittstelle an. Im DCE-Kompatibilitätsmodus muss der Schnittstellenname mit dem Namen der Schnittstelle übereinstimmen, die in der IDL-Datei angegeben ist. Wenn Sie den MIDL-Compilerschalter /acf verwenden, können sich der Schnittstellenname im ACF und der Schnittstellenname in der IDL-Datei unterscheiden.
-
filename-list
-
Gibt eine Liste mit einem oder mehreren C-Sprachheaderdateinamen an, getrennt durch Kommas. Der vollständige Dateiname, einschließlich der Erweiterung, muss angegeben werden.
-
type-attribute-list
-
Gibt eine Liste von einem oder mehreren Attributen getrennt durch Kommas an, die für den angegebenen Typ gelten. Gültige Typattribute sind [allocate].
-
Typename
-
Gibt einen typ an, der in der IDL-Datei definiert ist. Typattribute im ACF können nur auf Typen angewendet werden, die zuvor in der IDL-Datei definiert wurden.
-
ACF-Funktionsattribute
-
Gibt Attribute an, die für die Funktion als Ganzes gelten, z. B. [comm_status]. Funktionsattribute werden in eckige Klammern eingeschlossen. Trennen Sie mehrere Funktionsattribute durch Kommas.
-
Funktionsname
-
Gibt den Namen der Funktion an, wie in der IDL-Datei definiert.
-
ACF-Parameterattribute
-
Gibt ACF-Attribute an, die für einen Parameter gelten. Beachten Sie, dass null oder mehr Attribute auf den Parameter angewendet werden können. Trennen Sie mehrere Parameterattribute durch Kommas. ACF-Parameterattribute werden in eckige Klammern eingeschlossen.
-
Parametername
-
Gibt einen Parameter der Funktion an, wie in der IDL-Datei definiert. Jeder Parameter für die Funktion muss in derselben Sequenz angegeben werden und denselben Namen wie in der IDL-Datei verwenden.
Bemerkungen
Das [nocode] -Attribut kann im ACF-Header angezeigt werden, oder es kann auf eine einzelne Funktion angewendet werden.
Wenn das [nocode]- Attribut im ACF-Header angezeigt wird, wird der Clientstubcode für keine Remotefunktion generiert, es sei denn, er verfügt über das [code] -Funktionsattribute. Sie können das Attribut [nocode] im Header für eine einzelne Funktion überschreiben, indem Sie das Attribut [code] als Funktionsattribute angeben.
Wenn das Attribut [nocode] in der Attributliste der Funktion angezeigt wird, wird kein Clientstubcode für die Funktion generiert.
Clientstubcode wird nicht generiert, wenn:
- Der ACF-Header enthält das [nocode]- Attribut.
- Das [nocode] -Attribut wird auf die Funktion angewendet.
- Das Attribut [local] gilt für die Funktion in der Schnittstellendatei.
Entweder [Code] oder [nocode] kann in der Attributliste einer Funktion angezeigt werden, und die von Ihnen ausgewählte Eigenschaft kann genau einmal angezeigt werden.
Das [nocode] -Attribut wird ignoriert, wenn Serverstubs generiert werden. Sie können sie beim Generieren von Serverstubs im DCE-Kompatibilitätsmodus nicht anwenden.
Siehe auch