attributo comm_status
L'attributo [comm_status] ACF causa la restituzione di un codice di errore quando si verifica un errore di comunicazione durante l'esecuzione di una funzione.
[comm_status [ , ACF-function-attributes ] ]
error_status_t function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ...);
[ [ ACF-function-attributes ] ] function-name(
[comm_status [ , ACF-parameter-attributes ] ] error_status_t name
, ...);
Parametri
-
Attributi di funzione ACF
-
Specifica zero o più attributi di funzione ACF, ad esempio [comm_status] e [nocode]. Gli attributi della funzione sono racchiusi tra parentesi quadre. Zero o più attributi possono essere applicati a una funzione. Separare più attributi di funzione con virgole. Si noti che se [comm_status] viene visualizzato come attributo di funzione, non può essere visualizzato anche come attributo di parametro.
-
nome funzione
-
Specifica il nome della funzione come definito nel file IDL.
-
Attributi del parametro ACF
-
Specifica gli attributi che si applicano a un parametro. Si noti che zero, uno o più attributi possono essere applicati al parametro. Separare più attributi di parametro con virgole. Gli attributi dei parametri sono racchiusi tra parentesi quadre. Gli attributi dei parametri IDL, ad esempio gli attributi direzionali, non sono consentiti nell'ACF. Si noti che se [comm_status] viene visualizzato come attributo di parametro, non può essere visualizzato anche come attributo di funzione.
-
nome parametro
-
Specifica il parametro per la funzione come definito nel file IDL. Ogni parametro per la funzione deve essere specificato nella stessa sequenza usando lo stesso nome definito nel file IDL.
Commenti
L'attributo [comm_status] può essere usato come attributo di funzione o come attributo di parametro, ma può essere visualizzato una sola volta per funzione. Può essere applicato alla funzione o a un parametro in ogni funzione.
L'attributo [comm_status] può essere applicato solo alle funzioni che restituiscono il tipo error_status_t. Quando si verifica un errore di comunicazione durante l'esecuzione della funzione, viene restituito un codice di errore.
Quando [comm_status] viene usato come attributo di parametro, il parametro deve essere definito nel file IDL e deve essere un parametro [out] di tipo error_status_t. Quando si verifica un errore di comunicazione durante l'esecuzione della funzione, il parametro viene impostato sul codice di errore. Al termine della chiamata remota, la procedura imposta il valore.
È possibile che gli attributi [comm_status] e [fault_status] vengano visualizzati in una singola funzione, come attributi di funzione o attributi di parametro. Se entrambi gli attributi sono attributi di funzione o se si applicano allo stesso parametro e non si verifica alcun errore, la funzione o il parametro ha il valore error_status_ok. In caso contrario, contiene il valore [comm_status] appropriato o [fault_status] . Poiché i valori restituiti per [comm_status] sono diversi dai valori restituiti per [fault_status], i valori restituiti vengono interpretati in modo leggibile.
Vedi anche