attributo nocode
L'attributo [nocode] viene usato nelle intestazioni ACF o con singole funzioni per impedire la generazione di codice stub del client.
[
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 ;
...);
]
...
}
-
Attributi ACF-interface-attributes
-
Specifica un elenco di uno o più attributi che si applicano all'interfaccia nel suo complesso. Gli attributi validi includono [auto_handle] o [implicit_handle] e [code] o [nocode]. Quando sono presenti due o più attributi di interfaccia, devono essere separati da virgole.
-
interface-name
-
Specifica il nome dell'interfaccia. In modalità compatibilità DCE, il nome dell'interfaccia deve corrispondere al nome dell'interfaccia specificata nel file IDL. Quando si usa l'opzione /acf del compilatore MIDL, il nome dell'interfaccia in ACF e il nome dell'interfaccia nel file IDL possono essere diversi.
-
filename-list
-
Specifica un elenco di uno o più nomi di file di intestazione del linguaggio C, separati da virgole. È necessario specificare il nome completo del file, inclusa l'estensione.
-
type-attribute-list
-
Specifica un elenco di uno o più attributi, separati da virgole, che si applicano al tipo specificato. Gli attributi di tipo validi includono [allocate].
-
Typename
-
Specifica un tipo definito nel file IDL. Gli attributi di tipo in ACF possono essere applicati solo ai tipi definiti in precedenza nel file IDL.
-
Attributi ACF-function-attributes
-
Specifica gli attributi che si applicano alla funzione nel suo complesso, ad esempio [comm_status]. Gli attributi della funzione sono racchiusi tra parentesi quadre. Separare più attributi di funzione con virgole.
-
function-name
-
Specifica il nome della funzione come definito nel file IDL.
-
ACF-parameter-attributes
-
Specifica gli attributi ACF che si applicano a un parametro. Si noti che è possibile applicare zero o più attributi al parametro . Separare più attributi di parametro con virgole. Gli attributi dei parametri ACF sono racchiusi tra parentesi quadre.
-
parameter-name
-
Specifica un parametro della funzione come definito nel file IDL. Ogni parametro per la funzione deve essere specificato nella stessa sequenza e usando lo stesso nome definito nel file IDL.
L'attributo [nocode] può essere visualizzato nell'intestazione ACF oppure può essere applicato a una singola funzione.
Quando l'attributo [nocode] viene visualizzato nell'intestazione ACF, il codice stub del client non viene generato per alcuna funzione remota, a meno che non abbia l'attributo di funzione [code]. È possibile eseguire l'override dell'attributo [nocode] nell'intestazione per una singola funzione specificando l'attributo [code] come attributo di funzione.
Quando l'attributo [nocode] viene visualizzato nell'elenco di attributi della funzione, non viene generato alcun codice stub client per la funzione.
Il codice stub client non viene generato quando:
- L'intestazione ACF include l'attributo [nocode].
- L'attributo [nocode] viene applicato alla funzione.
- L'attributo [local] si applica alla funzione nel file di interfaccia.
[codice] o [nocode] può essere visualizzato nell'elenco di attributi di una funzione e quello scelto può essere visualizzato esattamente una volta.
L'attributo [nocode] viene ignorato quando vengono generati stub del server. Non è possibile applicarlo durante la generazione di stub del server in modalità di compatibilità DCE.