UiCreatePatchPackageEx (Patchwiz.dll)

La fonction UiCreatePatchPackageEx prend un fichier de création de package (fichier .pcp) et génère un package 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 d’accès complet au fichier de propriétés de création de correctifs (fichier .pcp) pour ce patch.

szPatchPath

Chemin d’accès complet au package correctif Windows Installer (fichier .msp) qui doit être créé. Ce paramètre peut être NULL ou une chaîne vide, mais ne peut pas être omis. Si elle est NULL ou une chaîne vide, la fonction utilisera la valeur de PatchOutputPath dans la table 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

Lien vers une fenêtre affichant 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 la valeur est TRUE, supprimez le dossier temporaire et tout son contenu s’il y en a. Si la valeur est FALSE et qu’un dossier est présent, la fonction échoue.

dwFlags

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

Indicateur	Valeur	Signification
LOGNONE	0x00000000	Ne rien écrire dans le journal.
LOGINFO	0x00000001	Écrire des messages d’information dans le journal.
LOGWARN	0x00000002	Écrire des messages d’avertissements dans le journal.
LOGERR	0x00000004	Écrire des messages d’erreur dans le journal.
LOGPERFMESSAGES	0x00000008	Écrire des messages de performances dans le journal.
UINONE	0x00000000f	Ne pas afficher l’interface utilisateur.
UIALL	0x00000010	Afficher 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.

Notes

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

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