attributo di codice
L'attributo ACF [code] causa la generazione del codice stub client per le funzioni remote.
[
code [ , ACF-interface-attributes ]
]
interface interface-name
{
[ include filename-list ; ]
[ typedef [type-attribute-list] typenam; ]
[ [code [ , 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], [nocode]o [optimize]. Quando sono presenti due o più attributi di interfaccia, devono essere separati da virgole.
-
interface-name
-
Specifica il nome dell'interfaccia.
-
filename-list
-
Specifica un elenco di uno o più nomi di file di intestazione 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] e [represent_as].
-
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 zero o più 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, uno 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 con lo stesso nome definito nel file IDL.
L'attributo [code] può essere visualizzato nell'intestazione ACF o può essere applicato a una singola funzione.
Quando l'attributo [code] viene visualizzato nell'intestazione ACF, il codice stub del client viene generato per tutte le funzioni remote che non hanno l'attributo di funzione [nocode]. È possibile eseguire l'override dell'attributo [code] nell'intestazione per una singola funzione specificando l'attributo [nocode] come attributo di funzione.
Quando l'attributo [code] viene visualizzato nell'elenco di attributi della funzione remota, il codice stub client viene generato 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 dell'interfaccia o della funzione, ma quello scelto può essere visualizzato una sola volta nell'elenco.