Funzione MsiAdvertiseScriptA (msi.h)
La funzione MsiAdvertiseScript copia un file di script annunciato nelle posizioni specificate.
Sintassi
UINT MsiAdvertiseScriptA(
[in] LPCSTR szScriptFile,
[in] DWORD dwFlags,
[in] PHKEY phRegData,
[in] BOOL fRemoveItems
);
Parametri
[in] szScriptFile
Percorso completo di un file di script generato da MsiAdvertiseProduct o MsiAdvertiseProductEx.
[in] dwFlags
I flag di bit seguenti dall'annuncio del controllo SCRIPTFLAGS. Il valore di dwFlags può essere una combinazione dei valori seguenti.
[in] phRegData
Chiave del Registro di sistema in cui devono essere scritte informazioni temporanee sui dati del Registro di sistema. Se questo parametro è Null, i dati del Registro di sistema vengono inseriti sotto la 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.
Si noti che questa chiave del Registro di sistema non può essere usata quando si genera un annuncio pubblicitario di un prodotto per un utente o un computer perché il provider della chiave del Registro di sistema elimina in genere la chiave. La chiave del Registro di sistema si trova all'esterno delle normali posizioni del Registro di sistema per shell, classe e .msi informazioni di configurazione e non è in HKEY_CLASSES_ROOT. Questa chiave del Registro di sistema è destinata solo a ottenere informazioni temporanee sui dati del Registro di sistema in uno script.
[in] fRemoveItems
TRUE se gli elementi specificati devono essere rimossi invece di essere creati.
Valore restituito
| Valore | Significato |
|---|---|
|
La funzione è stata completata correttamente. |
|
Il processo di chiamata non è in esecuzione nell'account LocalSystem. |
|
Vedere Codici di errore. |
| Si è verificato un errore relativo all'inizializzazione. | |
|
Questa funzione è disponibile solo in Windows 2000 e Windows XP. |
Commenti
Il processo che chiama questa funzione deve essere in esecuzione nell'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 MsiAdvertiseScript come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 i requisiti di Windows Installer Run-Time. |
| Piattaforma di destinazione | Windows |
| Intestazione | msi.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |