error_status_t屬性
error_status_t關鍵字會指定物件的類型,其中包含通訊狀態或錯誤狀態資訊。
[ [ , 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
, ...);
參數
-
ACF-function-attributes
-
指定零個或多個 ACF 函數屬性,例如[comm_status]、[fault_status]或[nocode]。 函式屬性會以方括弧括住。 零個或多個屬性可以套用至函式。 以逗號分隔多個函式屬性。
-
function-name
-
指定 IDL 檔案中所定義的函式名稱。
-
ACF-parameter-attributes
-
指定套用至參數的屬性。 請注意,零、一或多個屬性可以套用至 參數。 以逗號分隔多個參數屬性。 參數屬性會以方括弧括住。 ACF 中不允許 IDL 參數屬性,例如方向屬性。
-
parameter-name
-
指定 IDL 檔案中所定義之函式的參數。 函式的每個參數都必須以相同的順序指定,並使用與 IDL 檔案中所定義的相同名稱。
備註
error_status_t類型會當做 IDL 中例外狀況處理架構的一部分使用。 此類型會對應至 不帶正負號的 long。 攔截錯誤狀況的應用程式具有[out]參數或指定為error_status_t之程式的傳回類型,並使用 ACF 中的[comm_status]或[fault_status]屬性來限定error_status_t。 如果參數或傳回型別不是以 [comm_status] 或 [fault_status] 屬性限定,則參數的運作方式就像是未帶正負號的長。
從 2.0 版開始,MIDL 編譯器會產生包含正確錯誤處理架構的存根。 不過,舊版 MIDL 編譯器處理了參數或傳回型別 error_status_t ,就像套用 [comm_status] 和 [fault_status] 屬性一樣,即使它們不是也一樣。 使用 MIDL 2.0 或更新版本時,您必須明確地將 [comm_status] 和 [fault_status] 屬性套用至 ACF 中的參數或程式。
error_status_t類型是介面定義語言的其中一個預先定義類型。 預先定義的類型可以在 typedef 宣告、一般宣告和函式宣告子中顯示為類型規範, (做為 function-return-type 或參數類型規範) 。
另請參閱