Funzione MsiAdvertiseProductExW (msi.h)

Articolo
02/29/2024

La funzione MsiAdvertiseProductEx genera uno script pubblicitario o annuncia un prodotto al computer. Questa funzione consente a Windows Installer di scrivere in uno script le informazioni di registro e collegamento usate per assegnare o pubblicare un prodotto. Lo script può essere scritto in modo coerente con una piattaforma specificata usando MsiAdvertiseProductEx. La funzione MsiAdvertiseProductEx offre la stessa funzionalità di MsiAdvertiseProduct.

Sintassi

UINT MsiAdvertiseProductExW(
  [in] LPCWSTR szPackagePath,
  [in] LPCWSTR szScriptfilePath,
  [in] LPCWSTR szTransforms,
  [in] LANGID  lgidLanguage,
  [in] DWORD   dwPlatform,
  [in] DWORD   dwOptions
);

Parametri

[in] szPackagePath

Percorso completo del pacchetto del prodotto da annunciare.

[in] szScriptfilePath

Percorso completo del file di script da creare con le informazioni annunciate. Per annunciare il prodotto localmente al computer, impostare ADVERTISEFLAGS_MACHINEASSIGN o ADVERTISEFLAGS_USERASSIGN.

Contrassegno	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 utente specifico.

[in] szTransforms

Elenco delimitato da punti 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 la trasformazione del percorso completo sicuro. Per altre informazioni, vedere Trasformazioni protette. Questo parametro può essere null.

[in] lgidLanguage

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

[in] dwPlatform

Flag di bit che controllano per quale piattaforma il programma di installazione deve creare lo script. Questo parametro viene ignorato se szScriptfilePath è Null. Se dwPlatform è zero (0), lo script viene creato in base alla piattaforma corrente. Questa è la stessa funzionalità di MsiAdvertiseProduct. Se dwPlatform è 1 o 2, il programma di installazione crea lo script per la piattaforma specificata.

Contrassegno	Significato
nessuna 0	Crea uno script per la piattaforma corrente.
MSIARCHITECTUREFLAGS_X86 1	Crea uno script per la piattaforma x86.
MSIARCHITECTUREFLAGS_IA64 2	Crea uno script per i sistemi basati su Itanium.
MSIARCHITECTUREFLAGS_AMD64 4	Crea uno script per la piattaforma x64.

[in] dwOptions

Flag di bit che specificano opzioni di annuncio aggiuntive. Il valore non zero è disponibile solo nelle versioni di Windows Installer fornite con Windows Server 2003 e Windows XP con SP1 e versioni successive.

Contrassegno	Significato
MSIADVERTISEOPTIONS_INSTANCE 1	Più istanze tramite codice prodotto che modifica il flag di supporto per la trasformazione. Annuncia una nuova istanza del prodotto. Richiede che il parametro szTransforms includa la trasformazione dell'istanza che modifica il codice prodotto. Per altre informazioni, vedere Installazione di più istanze di prodotti e patch.

Valore restituito

Valore	Significato
ERROR_SUCCESS	La funzione viene completata correttamente.
Errore correlato a un'azione	Per altre informazioni, vedere Codici di errore.
Errore di inizializzazione	Si è verificato un errore di inizializzazione.
ERROR_CALL_NOT_IMPLEMENTED	Questo errore viene restituito se viene eseguito un tentativo di generare uno script di annuncio in qualsiasi piattaforma diversa da Windows 2000 o Windows XP. L'annuncio al computer locale è supportato in tutte le piattaforme.

Commenti

Più istanze tramite codice prodotto- trasformazioni di modifica sono disponibili solo per le versioni di Windows Installer in spedizione con Windows Server 2003 e Windows XP con SP1 e versioni successive.

Nota

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

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 i requisiti di Windows Installer Run-Time.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Installazioni multiple-package

Non supportato in Windows Installer 2.0 e versioni precedenti

Condividi tramite