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 |
---|---|
|
Unbekannter Fehler (nicht verwendet). |
|
Kein Fehler, identisch mit OLEUI_OK. |
|
Der Benutzer hat die Schaltfläche OK gedrückt. |
|
Der Benutzer hat die Schaltfläche Abbrechen gedrückt, und der Aufrufer sollte den Vorgang abbrechen. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Das Dialogfeld wurde informiert, dass der Vorgang nicht mehr blockiert wird. |
Standardfeldüberprüfungsfehler
Rückgabecode | Beschreibung |
---|---|
|
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. |
|
Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wird, war NULL-. |
|
Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur. |
|
Der wert cbstruct ist falsch. |
|
Der hWndOwner Wert ist ungültig. |
|
Der lpszCaption Wert ist ungültig. |
|
Der lpfnHook Wert ist ungültig. |
|
Der hInstance- Wert ist ungültig. |
|
Der wert lpszTemplate ist ungültig. |
|
Der hResource- Wert ist ungültig. |
Initialisierungsfehler
Rückgabecode | Beschreibung |
---|---|
|
Die Dialogfeldvorlage konnte nicht gefunden werden. |
|
Die Dialogfeldvorlage kann nicht geladen werden. |
|
Fehler bei der Initialisierung des Dialogfelds. |
|
Fehler beim Aufruf LocalAlloc- oder des Standard-IMalloc Allocator. |
|
Fehler beim Aufruf von GlobalAlloc oder der Standard-IMalloc Allocator. |
|
LoadString- für die lokalisierten Ressourcen aus der Bibliothek kann nicht aufgerufen werden. |
|
Fehler beim Aufruf des Standard-IMalloc Allocator. |
Funktionsspezifische Fehler
Rückgabecode | Beschreibung |
---|---|
|
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. |
|
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 |