Funzione MsiAdvertiseProductExA (msi.h)

Articolo
08/24/2023

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

Sintassi

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

Parametri

[in] szPackagePath

Percorso completo del pacchetto del prodotto pubblicizzato.

[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 punto e virgola di 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 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 la piattaforma in cui 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. Si tratta della 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 diverso da 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 il codice prodotto che modificano il flag di supporto della 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 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.

Commenti

Più istanze tramite trasformazioni di modifica del codice prodotto sono disponibili solo per le versioni di Windows Installer 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 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

Installazioni di più pacchetti

Non supportato in Windows Installer 2.0 e versioni precedenti

Condividi tramite