installApplication 函式 (appmgmt.h)
InstallApplication 函式可以安裝已部署至屬於網域之目標用戶的應用程式。 呼叫 InstallApplication 之使用者的安全性內容必須是登入網域中信任目標使用者網域之電腦的網域使用者。 當目標使用者登入時,必須成功套用 群組原則。
語法
DWORD InstallApplication(
[in] PINSTALLDATA pInstallInfo
);
參數
[in] pInstallInfo
INSTALLDATA 結構的指標,指定要安裝的應用程式。
傳回值
如果函式成功,傳回值會 ERROR_SUCCESS。 否則,函式會傳回其中一個系統錯誤碼。 如需錯誤碼的完整清單,請參閱 系統錯誤碼 或頭檔 WinError.h。
備註
InstallApplication 函式只能安裝已使用 群組原則 部署的應用程式。 網域管理員可以使用 群組原則 Objects (GPO) 的使用者設定區段,將應用程式部署至目標使用者。 目標用戶必須屬於目標網域,GPO 必須套用至目標網域中的這個使用者。 InstallApplication 函式會根據標準 群組原則 繼承規則來安裝應用程式。 如果相同的應用程式部署在多個 GPO 中,函式會安裝部署在最高優先順序 GPO 中的應用程式版本。 為使用者安裝應用程式之後,計算機上其他使用者看不到該應用程式。 這是透過使用者組策略部署之應用程式的標準。
InstallApplication 函式可以安裝使用 Windows Installer (.msi 檔案的已部署應用程式,) 或軟體安裝設定 (.zap 檔案) 來處理安裝和安裝。
InstallApplication 函式可以安裝使用 Windows Installer 套件進行安裝的應用程式。 在此情況下,呼叫 InstallApplication 的使用者不需要具有系統管理員許可權。 系統可以安裝應用程式,因為 Windows Installer 是網域系統管理員所部署的信任應用程式。 接收應用程式的用戶必須能夠存取 .msi 檔案的位置。
呼叫 Windows Installer 函式 MsiConfigureProduct 以卸載應用程式,以移除使用 .msi 檔案安裝的應用程式。 然後呼叫 UninstallApplication,通知系統應用程式不再由 群組原則 在用戶端上管理。 即使卸載失敗,也應該呼叫 UninstallApplication,因為這可讓系統保持原則的結果集 (RSoP) 正確。
InstallApplication 函式也可以根據軟體安裝設定 (.zap 檔案) 安裝應用程式來安裝應用程式。 接收應用程式的用戶必須能夠存取 .zap 檔案的位置。 .zap 檔案是類似 .ini 檔案的文本檔,可讓 Windows 發佈應用程式 (例如,Setup.exe) 以 新增或移除程序進行安裝。 若要發佈不使用 Windows Installer 的應用程式,您必須建立 .zap 檔案、將 .zap 檔案複製到軟體發佈點伺服器,然後使用以 群組原則 為基礎的軟體部署來發佈使用者的應用程式。 如果使用 .zap 檔案部署應用程式,則安裝應用程式的使用者必須在計算機上安裝軟體的許可權。 您無法將 .zap 檔案用於指派的應用程式。
呼叫卸載函式或安裝應用程式特定的命令,以移除使用軟體安裝設定 (.zap 檔案) 的應用程式。
For information about using installation applications other than the Windows Installer see article 231747, "How to Publish non-MSI Programs with .zap Files," in the Microsoft Knowledge Base.
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | appmgmt.h |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |
API 集合 | ext-ms-win-advapi32-msi-l1-1-0 (於 Windows 8) |