Funzione InstallApplication (appmgmt.h)

La funzione InstallApplication può installare le applicazioni distribuite agli utenti di destinazione appartenenti a un dominio. Il contesto di sicurezza dell'utente che chiama InstallApplication deve essere quello di un utente di dominio connesso a un computer in un dominio che considera attendibile il dominio dell'utente di destinazione. Criteri di gruppo deve essere applicato correttamente quando l'utente di destinazione accede.

Sintassi

DWORD InstallApplication(
  [in] PINSTALLDATA pInstallInfo
);

Parametri

[in] pInstallInfo

Puntatore a una struttura INSTALLDATA che specifica l'applicazione da installare.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS. In caso contrario, la funzione restituisce uno dei codici di errore di sistema. Per un elenco completo dei codici di errore, vedere Codici errore di sistema o il file di intestazione WinError.h.

Commenti

La funzione InstallApplication può installare solo le applicazioni distribuite tramite Criteri di gruppo. Un amministratore di dominio può distribuire le applicazioni agli utenti di destinazione usando la sezione di configurazione utente di Criteri di gruppo Oggetti Criteri di gruppo. L'utente di destinazione deve appartenere al dominio di destinazione e l'oggetto Criteri di gruppo deve essere applicato a questo utente nel dominio di destinazione. La funzione InstallApplication installa le applicazioni in base alle regole di ereditarietà standard Criteri di gruppo. Se la stessa applicazione viene distribuita in più oggetti Criteri di gruppo, la funzione installa la versione dell'applicazione distribuita nell'oggetto Criteri di gruppo con la precedenza più elevata. Dopo l'installazione di un'applicazione per un utente, non è visibile ad altri utenti del computer. Questo è lo standard per le applicazioni distribuite tramite criteri di gruppo utente.

La funzione InstallApplication può installare applicazioni distribuite che usano Windows Installer (file .msi) o impostazioni di installazione software (file con estensione zap) per gestire l'installazione e l'installazione.

La funzione InstallApplication può installare applicazioni che usano un pacchetto di Windows Installer per l'installazione. In questo caso, l'utente che chiama InstallApplication non deve avere privilegi di amministratore. Il sistema può installare l'applicazione perché Windows Installer è un'applicazione attendibile distribuita da un amministratore di dominio. L'utente che riceve l'applicazione deve avere accesso al percorso dei file .msi.

Rimuovere le applicazioni installate usando .msi file chiamando la funzione di Windows InstallerMsiConfigureProduct per disinstallare l'applicazione. Chiamare quindi UninstallApplication per informare il sistema che l'applicazione non è più gestita nel client da Criteri di gruppo. UninstallApplication deve essere chiamato anche se la disinstallazione non riesce perché consente al sistema di mantenere accurato il set di criteri risultante (RSoP).

La funzione InstallApplication può anche installare applicazioni che usano applicazioni di installazione basate sulle impostazioni di installazione software (file con estensione zap). L'utente che riceve l'applicazione deve avere accesso al percorso dei file con estensione zap. Un file con estensione zap è un file di testo simile a un file di .ini, che consente a Windows di pubblicare un'applicazione (ad esempio, Setup.exe) per l'installazione con Installazione applicazioni. Per pubblicare applicazioni che non usano Windows Installer, è necessario creare un file con estensione zap, copiare il file con estensione zap nei server del punto di distribuzione software e quindi usare Criteri di gruppo distribuzione software basata su per pubblicare l'applicazione per gli utenti. Se l'applicazione viene distribuita usando file con estensione zap, l'utente che installa l'applicazione deve disporre dei privilegi per installare il software. Non è possibile usare i file con estensione zap per le applicazioni assegnate.

Rimuovere le applicazioni usando le impostazioni di installazione software (file con estensione zap) chiamando la funzione di disinstallazione o un comando specifico per l'applicazione di installazione.

Per informazioni sull'uso di applicazioni di installazione diverse da Windows Installer , vedere l'articolo 231747 " Come pubblicare programmi non MSI con file con estensione zap" nella Microsoft Knowledge Base.

Requisiti

Vedi anche

Funzioni Criteri di gruppo

Panoramica di Criteri di gruppo

INSTALLDATA

MsiConfigureProduct

Creazione di report Criteri di gruppo

UninstallApplication

Windows Installer