OleUIPromptUserA-Funktion (oledlg.h)

Artikel
11/20/2024

Zeigt ein Dialogfeld mit der angegebenen Vorlage an und gibt die Antwort (Schaltflächenbezeichner) vom Benutzer zurück. Diese Funktion wird verwendet, um OLE-Warnmeldungen anzuzeigen, z. B. "Klasse nicht registriert".

Syntax

int OleUIPromptUserA(
  [in] int  nTemplate,
  [in] HWND hwndParent,
       ...  
);

Parameter

[in] nTemplate

Die Ressourcennummer des anzuzeigenden Dialogfelds. Siehe Anmerkungen.

[in] hwndParent

Das Handle für das übergeordnete Fenster des Dialogfelds.

...

Wahlfrei. Der Titel des Dialogfelds gefolgt von einer Liste von Argumenten für die Formatzeichenfolge im statischen Steuerelement (IDC_PU_TEXT) des Dialogfelds. Der Aufrufer muss sicherstellen, dass die richtige Anzahl und Typen von Argumenten übergeben werden.

Rückgabewert

Standard-Erfolgs-/Fehlerdefinitionen

Rückgabecode	Beschreibung
OLEUI_FALSE	Unbekannter Fehler (nicht verwendet).
OLEUI_OK	Der Benutzer hat die Schaltfläche OK gedrückt.
OLEUI_SUCCESS	Kein Fehler, identisch mit OLEUI_OK.
OLEUI_CANCEL	Der Benutzer hat die Schaltfläche Abbrechen gedrückt.

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 kann nicht für lokalisierte Ressourcen aus der Bibliothek 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.

Bemerkungen

Die folgenden Dialogfeldvorlagen sind in den Richtlinien für die Windows-Schnittstelle definiert – A Leitfaden für das Entwerfen von Software. Der nTemplate-Parameter muss eine derzeit definierte Ressource sein, zusätzliche Vorlagen können jedoch zu prompt.dlg hinzugefügt werden.

IDD_LINKSOURCEUNAVAILABLE 
IDD_CANNOTUPDATELINK 
IDD_SERVERNOTREG 
IDD_CANNOTRESPONDVERB 
IDD_SERVERNOTFOUND

Anmerkung

Der oledlg.h-Header definiert OleUIPromptUser 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

Freigeben über