Funzione MsiAdvertiseScriptW (msi.h)

  • Articolo

La funzione MsiAdvertiseScript copia un file di script pubblicizzato nei percorsi specificati.

Sintassi

UINT MsiAdvertiseScriptW(
  [in] LPCWSTR 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

Flag di bit seguenti dall'annuncio del controllo SCRIPTFLAGS. Il valore di dwFlags può essere una combinazione dei valori seguenti.

Contrassegno Significato
SCRIPTFLAGS_CACHEINFO
0x001
 Includere questo flag se le icone devono essere create o rimosse.
SCRIPTFLAGS_SHORTCUTS
0x004
 Includere questo flag se è necessario creare o rimuovere i tasti di scelta rapida.
SCRIPTFLAGS_MACHINEASSIGN
0x008
 Includere questo flag se il prodotto da assegnare a un computer.
SCRIPTFLAGS_REGDATA_CNFGINFO
0x020
 Includere questo flag se le informazioni di configurazione e gestione nei dati del Registro di sistema devono essere scritte o rimosse.
SCRIPTFLAGS_VALIDATE_TRANSFORMS_LIST
0x040
 Includere questo flag per forzare la convalida delle trasformazioni elencate nello script rispetto alle trasformazioni registrate in precedenza per questo prodotto. Si noti che i conflitti di trasformazione vengono rilevati usando un confronto tra stringhe senza distinzione tra maiuscole e minuscole e vengono valutati tra installazioni per utente e per computer in tutti i contesti. Se l'elenco di trasformazioni nello script non corrisponde alle trasformazioni registrate per il prodotto, la funzione restituisce ERROR_INSTALL_TRANSFORM_FAILURE.
SCRIPTFLAGS_REGDATA_CLASSINFO
0x080
 Includere questo flag se le informazioni sugli annunci nel Registro di sistema correlate alle classi COM devono essere scritte o rimosse.
SCRIPTFLAGS_REGDATA_EXTENSIONINFO
0x100
 Includere questo flag se le informazioni sull'annuncio nel Registro di sistema correlate a un'estensione devono essere scritte o rimosse.
SCRIPTFLAGS_REGDATA_APPINFO
0x180
 Includere questo flag se le informazioni sull'annuncio pubblicitario nel Registro di sistema devono essere scritte o rimosse.
SCRIPTFLAGS_REGDATA
0x1A0
 Includere questo flag se le informazioni sull'annuncio pubblicitario nel Registro di sistema devono essere scritte o rimosse.

[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 nella chiave appropriata, in base al fatto che l'annuncio sia per utente o per computer. Se questo parametro è diverso da 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 utilizzata durante la generazione di un annuncio di un prodotto per un utente o un computer perché il provider della chiave del Registro di sistema in genere elimina la chiave. La chiave del Registro di sistema si trova all'esterno dei normali percorsi 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
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 è disponibile solo in Windows 2000 e Windows XP.
 
 

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 MsiAdvertiseScript 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

Vedi anche

Contesto di installazione