Funzione MsiProcessAdvertiseScriptA (msi.h)

Articolo
11/20/2024

La funzione MsiProcessAdvertiseScript elabora un file 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 vengono scritti file di icona o trasformazione.

[in] hRegData

Chiave del Registro di sistema in cui scrivere 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 era 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Condividi tramite