新增 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. 無法變更。
  本機自訂介面	提供您自己的傳回型別，或從下拉式清單中選取。
  分配介面	提供您自己的傳回型別，或從下拉式清單中選取。

• 參數

  顯示方法的參數、修飾元和型別。

• +

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

• x

  從 [參數] 清單中移除選取的參數。

• 從型別推斷 in/out 參數值

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

• 將最後一個參數設定為傳回值 (retval)

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

• 屬性

  在 MIDL 參考中也會描述下列屬性。

  • id

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

  • call_as

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

  • helpcontext

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

  • helpstring

    指定用於描述所套用元素的字元字串。 如需詳細資訊，請參閱helpstring。

• 其他屬性

  • hidden

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

  • local

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

  • restricted

    指定無法任意呼叫的模組、介面或分配平面的程式庫或成員。 如需詳細資訊，請參閱restricted。

  • source

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

另請參閱

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