初始化應用程式

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

初始化應用程式

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，則所有專案都已列舉，而且不應該再次呼叫 函式。