Freigeben über


OleUIBusyW-Funktion (oledlg.h)

Ruft das Standarddialogfeld Beschäftigt auf, sodass der Benutzer die Parallelität verwalten kann.

Syntax

UINT OleUIBusyW(
  [in] LPOLEUIBUSYW unnamedParam1
);

Parameter

[in] unnamedParam1

Zeigen Sie 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:

Standard-Erfolgs-/Fehlerdefinitionen

Rückgabecode Beschreibung
OLEUI_FALSE
Unbekannter Fehler (nicht verwendet).
OLEUI_SUCCESS
Kein Fehler, identisch mit 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 Wechseln zu gedrückt, und OleUIBusy- konnte nicht bestimmen, wie sie zur blockierenden Anwendung wechseln. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt selbst zu lösen, falls möglich, oder versuchen Sie den Vorgang erneut. OleUIBusy- gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Umschalten zu gedrückt hat, hTask-NULL- ist und das BZ_NOTRESPONDING Flag festgelegt ist.
OLEUI_BZ_SWITCHTOSELECTED
Der Benutzer hat Wechseln zu gedrückt, und OleUIBusy- konnte nicht bestimmen, wie sie zur blockierenden Anwendung wechseln. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt selbst zu lösen, falls möglich, oder versuchen Sie den Vorgang erneut. OleUIBusy- gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Umschalten zu gedrückt hat, hTask-NULL- ist und das BZ_NOTRESPONDING Flag festgelegt ist.
OLEUI_BZ_SWITCHTOSELECTED
Der Benutzer hat Wechseln zu gedrückt, und OleUIBusy- konnte nicht bestimmen, wie sie zur blockierenden Anwendung wechseln. In diesem Fall sollte der Aufrufer entweder Maßnahmen ergreifen, um den Konflikt selbst zu lösen, falls möglich, oder versuchen Sie den Vorgang erneut. OleUIBusy- gibt nur OLEUI_BZ_SWITCHTOSELECTED zurück, wenn der Benutzer die Schaltfläche Umschalten zu gedrückt hat, hTask-NULL- ist und das BZ_NOTRESPONDING Flag festgelegt ist.
OLEUI_BZ_RETRYSELECTED
Der Benutzer hat entweder die Schaltfläche erneut versuchen oder versucht, den Konflikt zu lösen (wahrscheinlich durch Wechseln zur blockierenden Anwendung). In diesem Fall sollte der Aufrufer den Vorgang wiederholen.
OLEUI_BZ_CALLUNBLOCKED
Das Dialogfeld wurde informiert, dass der Vorgang nicht mehr blockiert wird.
 

Standardfeldüberprüfungsfehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMIN
Fehler, die für alle Dialogfelder üblich sind, liegen im Bereich OLEUI_ERR_STANDARDMIN, um 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 wird, war NULL-.
OLEUI_ERR_STRUCTUREINVALID
Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur.
OLEUI_ERR_CBSTRUCTINCORRECT
Der wert cbstruct 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 wert lpszTemplate 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 Initialisierung des Dialogfelds.
OLEUI_ERR_LOCALMEMALLOC
Fehler beim Aufruf LocalAlloc- oder des Standard-IMalloc Allocator.
OLEUI_ERR_GLOBALMEMALLOC
Fehler beim Aufruf von GlobalAlloc oder der Standard-IMalloc Allocator.
OLEUI_ERR_LOADSTRING
LoadString- für die lokalisierten Ressourcen aus der Bibliothek kann nicht aufgerufen werden.
OLEUI_ERR_OLEMEMALLOC
Fehler beim Aufruf des Standard-IMalloc Allocator.
 

Funktionsspezifische Fehler

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

Bemerkungen

Das Standardmäßige OLE Server-Beschäftigt- Dialogfeld benachrichtigt den Benutzer, dass die Serveranwendung keine Nachrichten empfängt. Das Dialogfeld fordert den Benutzer dann auf, den Vorgang abzubrechen, zu der aufgabe zu wechseln, die blockiert ist, oder den Wartevorgang fortzusetzen.

Anmerkung

Der oledlg.h-Header definiert OLEUIBUSY als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- oledlg.h
Library OleDlg.lib
DLL- OleDlg.dll

Siehe auch

OLEUIBUSY-