UiCreatePatchPackageEx (Patchwiz.dll)

La fonction UiCreatePatchPackageEx prend un fichier de création de package (fichier .pcp) et génère un package de correctif Windows Installer (package.msp). L’appel de Msimsp.exe est la méthode recommandée pour utiliser Patchwiz.dll.

La fonction UiCreatePatchPackageEx est disponible à partir de Patchwiz.dll version 4.0 et étend les fonctionnalités de la fonction UiCreatePatchPackage.

UINT UiCreatePatchPackageEx(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  BOOL fRemoveTempFolderContents,
  DWORD dwFlags,
  DWORD dwReserved    
);

Paramètres

szPcpPath

Chemin complet du fichier de propriétés de création de correctifs (fichier .pcp) pour ce correctif.

szPatchPath

Chemin complet du package de correctif Windows Installer (fichier.msp) à créer. Ce paramètre peut être NULL ou une chaîne vide, mais ne peut pas être omis. S’il s’agit d' NULL ou d’une chaîne vide, la fonction utilise la valeur de PatchOutputPath dans la table de propriétés (Patchwiz.dll).

szLogPath

Chemin d’accès complet à un fichier journal texte qui sera ajouté. Ce paramètre peut être NULL ou une chaîne vide, mais ne peut pas être omis.

hwndStatus

Gérer vers une fenêtre qui affiche le texte d’état. Ce paramètre peut être NULL ou une chaîne vide, mais ne peut pas être omis.

szTempFolder

Emplacement des fichiers temporaires. Ce paramètre peut être NULL ou une chaîne vide, mais ne peut pas être omis. L’utilisateur doit disposer de privilèges suffisants pour lire et écrire dans ce dossier. L’emplacement par défaut est %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Si TRUE, supprimez le dossier temporaire et tout son contenu s’il est présent. Si FAUXet que le dossier est présent, la fonction échoue.

dwFlags

Ce paramètre peut être défini sur une ou une combinaison des valeurs suivantes pour spécifier les options de journalisation ou d’interface utilisateur.

Drapeau	Valeur	Signification
LOGNONE	0x00000000	Écrivez aucun message dans le journal.
LOGINFO	0x00000001	Écrivez des messages d’information dans le journal.
LOGWARN	0x00000002	Écrivez des avertissements dans le journal.
LOGERR	0x00000004	Écrivez des messages d’erreur dans le journal.
LOGPERFMESSAGES	0x00000008	Écrivez des messages de performances dans le journal.
UINONE	0x00000000f	N’affichez pas l’interface utilisateur.
UIALL	0x00000010	Affichez l’interface utilisateur.

 

dwReserved

Réservé. Ce paramètre doit être défini sur zéro.

Valeurs de retour

Consultez le tableau dans Valeurs de retour pour UiCreatePatchPackage.

Remarques

Pour obtenir un exemple de création d’un fichier .pcp et d’utilisation de UiCreatePatchPackage pour générer un package de correctifs Windows Installer, consultez la section Un exemple de mise à jour corrective de petite mise à jour.

La création d’un correctif nécessite une image de configuration non compressée, telle qu’une image d’administration ou une image d’installation non compressée à partir d’un CD-ROM. UiCreatePatchPackage ne génère pas de correctifs binaires pour les fichiers dans les armoires.