UiCreatePatchPackageEx (Patchwiz.dll)

  • Article

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.