OleUIBusyA, fonction (oledlg.h)

  • Article

Appelle la boîte de dialogue Occupé standard, ce qui permet à l’utilisateur de gérer l’accès concurrentiel.

Syntaxe

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers une structure OLEUIBUSY qui contient les informations utilisées pour initialiser la boîte de dialogue.

Valeur retournée

Cette fonction retourne les valeurs suivantes :

Définitions de réussite/d’erreur standard

Code de retour Description
OLEUI_FALSE
 Échec inconnu (inutilisé).
OLEUI_SUCCESS
 Aucune erreur, identique à OLEUI_OK.
OLEUI_OK
 L’utilisateur a appuyé sur le bouton OK .
OLEUI_CANCEL
 L’utilisateur a appuyé sur le bouton Annuler et l’appelant doit annuler l’opération.
OLEUI_BZ_SWITCHTOSELECTED
 L’utilisateur a appuyé sur Basculer vers et OleUIBusy n’a pas pu déterminer comment basculer vers l’application bloquante. Dans ce cas, l’appelant doit prendre des mesures pour tenter de résoudre le conflit lui-même, si possible, ou réessayer l’opération. OleUIBusy retourne uniquement OLEUI_BZ_SWITCHTOSELECTED si l’utilisateur a appuyé sur le bouton Basculer vers , si hTask a la valeur NULL et si l’indicateur BZ_NOTRESPONDING est défini.
OLEUI_BZ_SWITCHTOSELECTED
 L’utilisateur a appuyé sur Basculer vers et OleUIBusy n’a pas pu déterminer comment basculer vers l’application bloquante. Dans ce cas, l’appelant doit prendre des mesures pour tenter de résoudre le conflit lui-même, si possible, ou réessayer l’opération. OleUIBusy retourne uniquement OLEUI_BZ_SWITCHTOSELECTED si l’utilisateur a appuyé sur le bouton Basculer vers , si hTask a la valeur NULL et si l’indicateur BZ_NOTRESPONDING est défini.
OLEUI_BZ_SWITCHTOSELECTED
 L’utilisateur a appuyé sur Basculer vers et OleUIBusy n’a pas pu déterminer comment basculer vers l’application bloquante. Dans ce cas, l’appelant doit prendre des mesures pour tenter de résoudre le conflit lui-même, si possible, ou réessayer l’opération. OleUIBusy retourne uniquement OLEUI_BZ_SWITCHTOSELECTED si l’utilisateur a appuyé sur le bouton Basculer vers , si hTask a la valeur NULL et si l’indicateur BZ_NOTRESPONDING est défini.
OLEUI_BZ_RETRYSELECTED
L’utilisateur a appuyé sur le bouton Réessayer ou a tenté de résoudre le conflit (probablement en basculant vers l’application bloquante). Dans ce cas, l’appelant doit réessayer l’opération.
OLEUI_BZ_CALLUNBLOCKED
La boîte de dialogue a été informée que l’opération n’est plus bloquée.
 

Erreurs de validation de champ standard

Code de retour Description
OLEUI_ERR_STANDARDMIN
 Les erreurs communes à toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_ERR_STRUCTURENULL
 Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL.
OLEUI_ERR_STRUCTUREINVALID
 Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
La valeur cbstruct est incorrecte.
OLEUI_ERR_HWNDOWNERINVALID
 La valeur hWndOwner n’est pas valide.
OLEUI_ERR_LPSZCAPTIONINVALID
 La valeur lpszCaption n’est pas valide.
OLEUI_ERR_LPFNHOOKINVALID
 La valeur lpfnHook n’est pas valide.
OLEUI_ERR_HINSTANCEINVALID
 La valeur hInstance n’est pas valide.
OLEUI_ERR_LPSZTEMPLATEINVALID
 La valeur lpszTemplate n’est pas valide.
OLEUI_ERR_HRESOURCEINVALID
 La valeur hResource n’est pas valide.
 

Erreurs d’initialisation

Code de retour Description
OLEUI_ERR_FINDTEMPLATEFAILURE
 Impossible de trouver le modèle de boîte de dialogue.
OLEUI_ERR_LOADTEMPLATEFAILURE
 Impossible de charger le modèle de boîte de dialogue.
OLEUI_ERR_DIALOGFAILURE
 Échec de l’initialisation de la boîte de dialogue.
OLEUI_ERR_LOCALMEMALLOC
 Un appel à LocalAlloc ou à l’allocator IMalloc standard a échoué.
OLEUI_ERR_GLOBALMEMALLOC
 Un appel à GlobalAlloc ou à l’allocateur IMalloc standard a échoué.
OLEUI_ERR_LOADSTRING
 Impossible d’appeler LoadString pour les ressources localisées à partir de la bibliothèque.
OLEUI_ERR_OLEMEMALLOC
 Un appel à l’allocateur IMalloc standard a échoué.
 

Erreurs spécifiques à la fonction

Code de retour Description
OLEUI_ERR_STANDARDMAX
 Les erreurs communes à toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_BZERR_HTASKINVALID
 Le hTask spécifié dans le membre hTask de la structure OLEUIBUSY n’est pas valide.

Remarques

La boîte de dialogue OLE Server Busy standard avertit l’utilisateur que l’application serveur ne reçoit pas de messages. La boîte de dialogue demande ensuite à l’utilisateur d’annuler l’opération, de basculer vers la tâche bloquée ou de continuer à attendre.

Notes

L’en-tête oledlg.h définit OLEUIBUSY en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête oledlg.h
Bibliothèque OleDlg.lib
DLL OleDlg.dll

Voir aussi

OLEUIBUSY