Funzione MsiProcessAdvertiseScriptA (msi.h)

La funzione MsiProcessAdvertiseScript elabora un file di script di annuncio nei percorsi specificati.

Sintassi

UINT MsiProcessAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] LPCSTR szIconFolder,
  [in] HKEY   hRegData,
  [in] BOOL   fShortcuts,
  [in] BOOL   fRemoveItems
);

Parametri

[in] szScriptFile

Percorso completo di un file di script generato da MsiAdvertiseProduct o MsiAdvertiseProductEx.

[in] szIconFolder

Percorso facoltativo di una cartella in cui si trovano i file icona annunciati e i file di trasformazione. Se questo parametro è NULL, non viene scritta alcuna icona o file di trasformazione.

[in] hRegData

Chiave del Registro di sistema in cui devono essere scritti i dati del Registro di sistema. Se questo parametro è NULL, il programma di installazione scrive i dati del Registro di sistema nella chiave appropriata, in base al fatto che l'annuncio sia per utente o per computer. Se questo parametro non è NULL, lo script scriverà i dati del Registro di sistema nella chiave del Registro di sistema specificata anziché nella posizione normale. In questo caso, l'applicazione non verrà pubblicizzata all'utente.

[in] fShortcuts

TRUE se devono essere creati collegamenti. Se una cartella speciale viene restituita da SHGetSpecialFolderLocation , conterrà i collegamenti.

[in] fRemoveItems

TRUE se gli elementi specificati devono essere rimossi anziché creati.

Valore restituito

Valore Significato
ERROR_SUCCESS
La funzione è stata completata correttamente.
ERROR_ACCESS_DENIED
Il processo chiamante non è in esecuzione con l'account LocalSystem.
Errore relativo a un'azione
Vedere Codici di errore.
Errore di inizializzazione
Si è verificato un errore relativo all'inizializzazione.
ERROR_CALL_NOT_IMPLEMENTED
Questa funzione non è disponibile per questa piattaforma.
 
 

Commenti

Il processo che chiama questa funzione deve essere in esecuzione con l'account LocalSystem. Per annunciare un'applicazione per l'installazione per utente a un utente di destinazione, il thread che chiama questa funzione deve rappresentare l'utente di destinazione. Se il thread che chiama questa funzione non rappresenta un utente di destinazione, l'applicazione viene pubblicizzata a tutti gli utenti per l'installazione con privilegi elevati.

Nota

L'intestazione msi.h definisce MsiProcessAdvertiseScript come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione Windows
Intestazione msi.h
Libreria Msi.lib
DLL Msi.dll