Condividi tramite


Funzione MsiAdvertiseProductA (msi.h)

La funzione msiAdvertiseProduct genera uno script di annuncio o annuncia un prodotto al computer. La funzione msiAdvertiseProduct consente al programma di installazione di scrivere in uno script le informazioni sul Registro di sistema e sui collegamenti usati per assegnare o pubblicare un prodotto. Lo script può essere scritto in modo che sia coerente con una piattaforma specificata usando MsiAdvertiseProductEx.

Sintassi

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Parametri

[in] szPackagePath

Percorso completo del pacchetto del prodotto pubblicizzato.

[in] szScriptfilePath

Percorso completo del file di script che verrà creato con le informazioni di annuncio. Per annunciare il prodotto localmente al computer, impostare ADVERTISEFLAGS_MACHINEASSIGN o ADVERTISEFLAGS_USERASSIGN.

Bandiera Significato
ADVERTISEFLAGS_MACHINEASSIGN
0
Impostare per annunciare un'installazione per computer del prodotto disponibile per tutti gli utenti.
ADVERTISEFLAGS_USERASSIGN
1
Impostare per annunciare un'installazione per utente del prodotto disponibile per un determinato utente.

[in] szTransforms

Elenco delimitato da punto e virgola delle trasformazioni da applicare. L'elenco di trasformazioni può essere preceduto da @ o | carattere per specificare la memorizzazione nella cache sicura delle trasformazioni. Il prefisso @ specifica trasformazioni secure-at-source e | il prefisso indica trasformazioni di percorso completo sicure. Per altre informazioni, vedere trasformazioni protette. Questo parametro può essere Null.

[in] lgidLanguage

Lingua di installazione da usare se l'origine supporta più lingue.

Valore restituito

Valore Significato
ERROR_SUCCESS
La funzione è stata completata correttamente.
Errore relativo a un'azione
Vedere codici di errore.
errore di inizializzazione
Si è verificato un errore di inizializzazione.
ERROR_CALL_NOT_IMPLEMENTED
Questo errore viene restituito se viene effettuato un tentativo di generare uno script di annuncio su qualsiasi piattaforma diversa da Windows 2000 o Windows XP. L'annuncio al computer locale è supportato in tutte le piattaforme.

Osservazioni

Nota

L'intestazione msi.h definisce MsiAdvertiseProduct 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

Vedere anche

Multiple-Package installazioni