初始化應用程式

若要啟用安裝程式功能，應用程式必須在初始化時呼叫數個函式。 如需詳細資訊，請參閱 安裝機制。 下列步驟說明如何使用安裝程式來初始化應用程式：

初始化應用程式

1. 呼叫 MsiGetProductCode 函式，讓應用程式可以自行識別至安裝程式。

   產品代碼是許多安裝程式函式的必要參數。

2. 呼叫 MsiGetUserInfo 函式，以在第一次啟動應用程式時收集用戶資訊。

   如果呼叫 MsiGetUserInfo 失敗，請呼叫 MsiCollectUserInfo 函式來收集用戶資訊。

3. 視需要呼叫 MsiSetInternalUI 函式，來顯示預設的使用者介面。

   若要撰寫您自己的使用者介面，請呼叫 MsiSetExternalUI 函式，向安裝程式註冊它。

4. 呼叫 MsiEnableLog 函式來設定記錄層級。

5. 藉由列舉應用程式的功能，向用戶呈現可用的功能。 您可以透過下列方式列舉功能：

   • 逐一查詢安裝程式功能。 例如，在應用程式繪製按鈕或功能表項之前，應用程式會呼叫 MsiQueryFeatureState 函式，讓安裝程式可以檢查功能是否可用。
   • 藉由呼叫 MsiEnumFeatures 函式，一次列舉所有可用的功能。 若要使用此函式，應用程式必須在遞增索引時重複呼叫 MsiEnumFeatures。

6. 重複呼叫下列列舉函式，遞增每個呼叫的索引變數，以取得目前安裝的詳細資訊：

   • 呼叫 MsiEnumProducts 函式，以列舉向安裝程式註冊的產品。
   • 呼叫 MsiEnumComponents 函式來列舉元件。
   • 呼叫 MsiEnumComponentQualifiers 函式來列舉元件限定符。
   • 呼叫 MsiEnumClients 函式來列舉特定元件的產品。

   如果列舉函式的回傳值是 ERROR_SUCCESS，表示仍有其他項目需要列舉，應使用遞增的索引變數再次呼叫該函式。 如果傳回值是ERROR_NO_MORE_ITEMS，那麼所有項目都已列舉，並且不應該再次呼叫該函式。