Le Centre W..D..

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

Membre de Click-FR®, Réseau francophone Paie-Par-Click

SetupCopyError

Date de parution : 01/02/2003 - Cette fiche API a été lue 1104 fois

Description

SetupCopyError génère une boîte de dialogue pour notifier à l’utilisateur qu’une erreur de copie est survenue. La fonction retourne une des valeurs suivantes :

DPROMPT_SUCCESS	Tout s’est bien passé.
DPROMPT_CANCEL	L’utilisateur a abandonné la boîte.
DPROMPT_SKIPFILE	L’utilisateur a cliqué sur le bouton Ignorer.
DPROMPT_BUFFERTOOSMALL	PathBuffer est trop petit. Vérifier la taille de PathRequiredSize.
DPROMPT_OUTOFMEMORY	Mémoire insuffisante pour achever l’opération.

Syntaxe

AppelDLL32("setupapi", "SetupCopyErrorA", hwndParent, ... &DialogTitle, &DiskName, &PathToSource, &SourceFile, ... &TargetPathFile, Win32ErrorCode, ... Style, PathBuffer, PathBufferSize, PathRequiredSize)

hwndParent

[e] Handle de la fenêtre mère pour cette boîte de dialogue.

DialogTitle

[e] Pointeur sur une chaîne à terminateur nul qui précise le titre de la boîte. Si ce paramètre est à Null, un titre par défaut est utilisé.

DiskName

[e] Pointeur sur une chaîne à terminateur nul qui précise le nom du disque à insérer. Si ce paramètre est à Null, la valeur par défaut est appliquée.

PathToSource

[e] Pointeur sur une chaîne à terminateur nul qui précise le nom du fichier source sur lequel l’opération a faillit.

SourceFile

[e] Pointeur sur une chaîne à terminateur nul qui précise le nom du fichier sur lequel l’opération a faillit. Ce fichier sera affiché si l’utilisateur clique sur les boutons Parcourir ou Détails.

TargetPathFile

[e] Paramètre optionnel qui pointe sur une chaîne à terminateur nul qui spécifie le chemin complet du fichier destination pour les opérations de renommage ou de copie.

Win32ErrorCode

[s] Erreur Win32 rencontrée pendant l’opération. Se reporter au fichier WINERROR.H

Style

[e] Précise le sémaphore qui contrôle l’affichage et le formatage de la boîte. Ce peut être une des valeurs suivantes :

IDF_NOBROWSE	Pas d’option Parcourir
IDF_NOSKIP	Pas d’option Ignorer
IDF_NODETAILS	Pas d’option Détails. Si ce sémaphore est mis, TargetPathFile et Win32ErrorCode peuvent être omis.
IDF_NOCOMPRESSED	Ne vérifie pas la version de compression du fichier source.
IDF_OEMDISK	La source est fournie par un fabriquant de matériel.
IDF_NOBEEP	Emet un bip pour attirer l’attention de l’utilisateur lors de l’apparition de la boîte.
IDF_NOFOREGROUND	Prévient la boîte lors de sa venue en avant-plan.
IDF_WARNIFSKIP	Avertit l’utilisateur qu’ignorer le fichier peut affecter l’installation.

PathBuffer

[s] Retourne le chemin (sans inclure le nom du fichier) de l’endroit que l’utilisateur a précisé à travers la boîte.

PathBufferSize

[s] Spécifie la taille de PathBuffer.

PathRequiredSize

[s] Paramètre optionnel vers une variable dans laquelle la fonction retourne la taille du tampon requis.

Compatibilité

Windows 95 : supporté.

Windows 98 : supporté.

Windows NT : réclame Windows NT 4.0 ou plus.

Windows 2000 : supporté.

Remarque

Aucune

Exemple 1

// Affiche une boîte lors d’une erreur de copie
hWnd est un entier long 
hWnd = Handle()

// Du code offert par Beaussier en ligne !
CallDll32("setupapi", "SetupCopyErrorA", ...
hWnd, "Erreur de copie", "C:\", "MonRep\quelquepart", ...
"monfic.ex_", "monfic.ext", 0, 0, Null, 0, 0)

Nombre de commentaire sur SetupCopyError : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..