attributo error_status_t
La parola chiave error_status_t designa un tipo per un oggetto che contiene informazioni sullo stato di comunicazione o sullo stato di errore.
[ [ , ACF-function-attributes ] ] error_status_t function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ...);
[ [ ACF-function-attributes ] ] function-name(
[ [ ACF-parameter-attributes ] ] error_status_t parameter-name
, ...);
Parametri
-
Attributi di funzione ACF
-
Specifica zero o più attributi di funzione ACF, ad esempio [comm_status], [fault_status]o [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.
-
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.
-
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
Il tipo di error_status_t viene usato come parte dell'architettura di gestione delle eccezioni in IDL. Questo tipo esegue il mapping a un lungosenza segno. Le applicazioni che rilevano le situazioni di errore hanno un parametro [out] o un tipo restituito di una routine specificata come error_status_t e qualificano l'error_status_t con gli attributi [comm_status] o [fault_status] nell'ACF. Se il parametro o il tipo restituito non è stato qualificato con gli attributi [comm_status] o [fault_status], il parametro funziona come se fosse un long senza segno.
A partire dalla versione 2.0, il compilatore MIDL genera stub che contengono l'architettura di gestione degli errori corretta. Tuttavia, le versioni precedenti del compilatore MIDL hanno gestito un parametro o un tipo restituito di error_status_t come se gli attributi [comm_status] e [fault_status] venivano applicati, anche se non erano. Con MIDL 2.0 o versioni successive, è necessario applicare in modo esplicito gli attributi [comm_status] e [fault_status] al parametro o alla routine nel servizio ACF.
Il tipo error_status_t è uno dei tipi predefiniti del linguaggio di definizione dell'interfaccia. I tipi predefiniti possono essere visualizzati come identificatori di tipo nelle dichiarazioni typedef , nelle dichiarazioni generali e nei dichiaratori di funzione (come identificatori di tipo function-return o come identificatori di tipo parametro).
Vedi anche