新增IDL方法

[新增IDL 方法] 精靈會將方法新增至介面定義連結庫 （IDL） 介面，例如在包含IDL檔案的ATL專案中。 此精靈不適用於支援 MFC 的專案。

此精靈與 [新增方法精 靈] 和 [新增 IDL MFC 方法 精靈] 不同，方式如下：

• [新增方法精靈] 會將方法新增至專案中的介面，並可更新與 介面相關聯的類別。
• [ 新增 IDL MFC 方法 精靈] 專屬於支援 MFC 的 MFC、ActiveX 或 ATL 專案。

將方法新增至IDL介面

1. 在 [ 檢視] 功能表上，選取 [類別檢視]。

2. 在 [ 類別檢視] 窗格中，展開項目節點以顯示您要新增方法的IDL介面（.idl檔案）。

3. 以滑鼠右鍵按一下介面的名稱。

4. 在快捷方式功能表上，選取 [新增>方法]。

5. 在 [ 新增 IDL 方法 精靈] 中，提供建立方法的資訊。

6. 選取 [ 確定 ] 以新增 方法。

使用者介面項目清單

下一節說明您將用來新增方法的精靈介面：

• 方法名稱

  提供方法的名稱。

• 傳回類型

  方法傳回的資料類型。 從介面中定義的方法傳回錯誤碼的標準方式是 使用 HRESULT。

  下表描述您可以加入方法的不同介面類型，以及允許的傳回型別。 針對雙重和自定義介面，傳回類型必須是 HRESULT ，而且精靈不會允許您變更它。

  介面種類	傳回類型
  雙重介面	HRESULT. 無法變更。
  自定義介面	HRESULT. 無法變更。
  本機自訂介面	提供您自己的傳回類型，或從下拉式清單中選取它。
  Dispinterface	提供您自己的傳回類型，或從下拉式清單中選取它。

• 參數

  顯示方法的參數、修飾詞和類型。

• +

  新增參數。 在 [ 參數] 中，輸入參數類型、名稱和任何修飾詞。 例如， [in] int i選擇 [ 確定]。

• x

  從 [參數 ] 列表中移除選取的參數。

• 從類型推斷/輸出參數值

  [in]根據參數的類型插入 或 [out] 屬性。

• 將最後一個參數設定為傳回值 （retval）

  最後一個參數會被視為方法的傳回值。

• 屬性

  MIDL 參考中也會說明下列屬性。

  • id

    設定識別方法的數值標識碼。 如需詳細資訊，請參閱id。

  • call_as

    指定要對應至這個本機方法之遠端方法的名稱。 如需詳細資訊，請參閱call_as。

  • helpcontext

    指定內容識別碼，讓使用者可在說明檔中檢視此方法的相關資訊。 如需詳細資訊，請參閱helpcontext。

  • helpstring

    指定用來描述其套用之專案的字元字串。 如需詳細資訊，請參閱helpstring。

• 其他屬性

  • hidden

    表示專案存在，但不應該顯示在用戶導向的瀏覽器中。 如需詳細資訊，請參閱hidden。

  • local

    指定介面或函式不是遠端的。 如需詳細資訊，請參閱local。

  • restricted

    指定無法任意呼叫模組、介面或 dispinterface 的連結庫或成員。 如需詳細資訊，請參閱restricted。

  • source

    表示 、屬性或方法的成員 coclass是事件的來源。 對於的成員 coclass，這個屬性表示呼叫成員而不是實作。 如需詳細資訊，請參閱source。

另請參閱

新增方法精靈
新增IDL MFC方法精靈