attributo fault_status
L'attributo [fault_status] ACF specifica che un codice di errore di tipo error_status_t indica un errore della procedura remota, anziché altri tipi di problemi, ad esempio errori di comunicazione.
[fault_status [ , ACF-function-attributes ] ] function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ... );
[ [ ACF-function-attributes ] ] function-name(
[fault_status [ , ACF-parameter-attributes ] ] parameter-name
, ... );
Parametri
-
Attributi di funzione ACF
-
Specifica zero o più attributi di funzione ACF, ad esempio [fault_status] e [nocode]. Gli attributi della funzione sono racchiusi tra parentesi quadre. Si noti che è possibile applicare zero o più attributi a una funzione. Separare più attributi di funzione con virgole. Si noti anche che se [fault_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 è possibile applicare zero o più attributi al parametro. Gli attributi dei parametri sono racchiusi tra parentesi quadre. Separare più attributi di parametro con virgole. Gli attributi dei parametri IDL, ad esempio gli attributi direzionali, non sono consentiti nell'ACF. Si noti che se [fault_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 [fault_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 stessa o a un parametro in ogni funzione.
L'attributo [fault_status] può essere applicato solo alle funzioni che restituiscono il tipo error_status_t. Quando la procedura remota non riesce in modo che venga restituito un PDU di errore, viene restituito un codice di errore.
Quando [fault_status] viene usato come attributo di parametro, il parametro deve essere un parametro [out] di tipo error_status_t. Se si verifica un errore del server, il parametro viene impostato sul codice di errore. Al termine della chiamata remota, la procedura imposta il valore.
Il parametro associato all'attributo [fault_status] non deve essere specificato nel file IDL. Quando il parametro non viene specificato, viene generato un nuovo parametro out di tipo error_status_t seguendo l'ultimo parametro definito nel file IDL DCE.
È possibile che gli attributi [fault_status] e [comm_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 del codice di stato appropriato. Poiché i valori restituiti per [fault_status] sono diversi dai valori restituiti per [comm_status], i valori restituiti vengono interpretati in modo leggibile.
Vedi anche