OleUIBusyA-Funktion (oledlg.h)

Artikel
11/20/2024

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

Syntax

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA 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-

Freigeben über