OleUIBusyA-Funktion (oledlg.h)

  • Artikel

Ruft das standardmäßige Dialogfeld Beschäftigt auf, sodass der Benutzer die Parallelität verwalten kann.

Syntax

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Parameter

[in] unnamedParam1

Zeiger auf eine OLEUIBUSY-Struktur , die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden.

Rückgabewert

Diese Funktion gibt die folgenden Werte zurück:

Standarddefinitionen für Erfolg/Fehler

Rückgabecode Beschreibung
OLEUI_FALSE
 Unbekannter Fehler (nicht verwendet).
OLEUI_SUCCESS
 Kein Fehler, wie OLEUI_OK.
OLEUI_OK
 Der Benutzer hat die Schaltfläche OK gedrückt.
OLEUI_CANCEL
 Der Benutzer hat die Schaltfläche Abbrechen gedrückt, und der Aufrufer sollte den Vorgang abbrechen.
OLEUI_BZ_SWITCHTOSELECTED
 Der Benutzer hat umschalten auf gedrückt, und OleUIBusy konnte nicht ermitteln, wie zur blockierenden Anwendung gewechselt werden soll. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt nach Möglichkeit selbst zu lösen, oder den Vorgang wiederholen. OleUIBusy gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Wechseln zu gedrückt hat, hTasknull ist und das flag BZ_NOTRESPONDING festgelegt ist.
OLEUI_BZ_SWITCHTOSELECTED
 Der Benutzer hat umschalten auf gedrückt, und OleUIBusy konnte nicht ermitteln, wie zur blockierenden Anwendung gewechselt werden soll. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt nach Möglichkeit selbst zu lösen, oder den Vorgang wiederholen. OleUIBusy gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Wechseln zu gedrückt hat, hTasknull ist und das flag BZ_NOTRESPONDING festgelegt ist.
OLEUI_BZ_SWITCHTOSELECTED
 Der Benutzer hat umschalten auf gedrückt, und OleUIBusy konnte nicht ermitteln, wie zur blockierenden Anwendung gewechselt werden soll. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt nach Möglichkeit selbst zu lösen, oder den Vorgang wiederholen. OleUIBusy gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Wechseln zu gedrückt hat, hTasknull ist und das flag BZ_NOTRESPONDING festgelegt ist.
OLEUI_BZ_RETRYSELECTED
Der Benutzer hat entweder auf die Schaltfläche "Wiederholen " geklickt oder versucht, den Konflikt zu lösen (wahrscheinlich durch Den Wechsel zur blockierenden Anwendung). In diesem Fall sollte der Aufrufer den Vorgang wiederholen.
OLEUI_BZ_CALLUNBLOCKED
Das Dialogfeld wurde darüber informiert, dass der Vorgang nicht mehr blockiert wird.
 

Standardfeldvalidierungsfehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMIN
 Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.
OLEUI_ERR_STRUCTURENULL
 Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wurde, war NULL.
OLEUI_ERR_STRUCTUREINVALID
 Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur.
OLEUI_ERR_CBSTRUCTINCORRECT
Der cbstruct-Wert ist falsch.
OLEUI_ERR_HWNDOWNERINVALID
 Der hWndOwner-Wert ist ungültig.
OLEUI_ERR_LPSZCAPTIONINVALID
 Der lpszCaption-Wert ist ungültig.
OLEUI_ERR_LPFNHOOKINVALID
 Der lpfnHook-Wert ist ungültig.
OLEUI_ERR_HINSTANCEINVALID
 Der hInstance-Wert ist ungültig.
OLEUI_ERR_LPSZTEMPLATEINVALID
 Der lpszTemplate-Wert ist ungültig.
OLEUI_ERR_HRESOURCEINVALID
 Der hResource-Wert ist ungültig.
 

Initialisierungsfehler

Rückgabecode Beschreibung
OLEUI_ERR_FINDTEMPLATEFAILURE
 Die Dialogfeldvorlage konnte nicht gefunden werden.
OLEUI_ERR_LOADTEMPLATEFAILURE
 Die Dialogfeldvorlage kann nicht geladen werden.
OLEUI_ERR_DIALOGFAILURE
 Fehler bei der Dialogfeldinitialisierung.
OLEUI_ERR_LOCALMEMALLOC
 Ein Aufruf von LocalAlloc oder der IMalloc-Standardzuweisung ist fehlgeschlagen.
OLEUI_ERR_GLOBALMEMALLOC
 Fehler beim Aufruf von GlobalAlloc oder der IMalloc-Standardzuweisung .
OLEUI_ERR_LOADSTRING
 LoadString für die lokalisierten Ressourcen aus der Bibliothek kann nicht aufgerufen werden.
OLEUI_ERR_OLEMEMALLOC
 Fehler beim Aufruf der IMalloc-Standardzuweisung .
 

Funktionsspezifische Fehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMAX
 Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.
OLEUI_BZERR_HTASKINVALID
 Der im hTask-Member der OLEUIBUSY-Struktur angegebene hTask ist ungültig.

Hinweise

Im Standardmäßigen DIALOGFELD OLE Server ausgelastet wird der Benutzer darüber informiert, dass die Serveranwendung keine Nachrichten empfängt. Im Dialogfeld wird der Benutzer dann aufgefordert, den Vorgang abzubrechen, zu der blockierten Aufgabe zu wechseln oder das Warten fortzusetzen.

Hinweis

Der oledlg.h-Header definiert OLEUIBUSY als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oledlg.h
Bibliothek OleDlg.lib
DLL OleDlg.dll

Weitere Informationen

OLEUIBUSY