Freigeben über

OleUIPromptUserA-Funktion (oledlg.h)

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