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 或參數類型規範) 。

另請參閱

comm_status

fault_status

介面定義 (IDL) 檔案

long

out

typedef

符號