Funzione MsiProcessAdvertiseScriptW (msi.h)
La funzione MsiProcessAdvertiseScript elabora un file di script di annuncio nei percorsi specificati.
Sintassi
UINT MsiProcessAdvertiseScriptW(
[in] LPCWSTR szScriptFile,
[in] LPCWSTR 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 |
---|---|
|
La funzione è stata completata correttamente. |
|
Il processo chiamante non è in esecuzione con l'account LocalSystem. |
|
Vedere Codici di errore. |
Si è verificato un errore relativo all'inizializzazione. | |
|
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
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 |