OleUIPromptUserW-Funktion (oledlg.h)

  • Artikel

Zeigt ein Dialogfeld mit der angegebenen Vorlage an und gibt die Antwort (Schaltflächenbezeichner) des Benutzers zurück. Diese Funktion wird verwendet, um OLE-Warnmeldungen anzuzeigen, z. B. Class Not Registered.

Syntax

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

Parameter

[in] nTemplate

Die Ressourcennummer des anzuzeigenden Dialogfelds. Siehe Hinweise.

[in] hwndParent

Das Handle zum übergeordneten Fenster des Dialogfelds.

...

Optional. 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 sicher sein, dass er die richtige Anzahl und die richtigen Argumenttypen übergibt.

Rückgabewert

Standarddefinitionen für Erfolg/Fehler

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 allen Dialogfeldern gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN 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 wurde, war NULL.
OLEUI_ERR_STRUCTUREINVALID
 Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur.
OLEUI_ERR_CBSTRUCTINCORRECT
 Der cbstruct-Wert 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 lpszTemplate-Wert 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 Dialogfeldinitialisierung.
OLEUI_ERR_LOCALMEMALLOC
 Ein Aufruf von LocalAlloc oder der IMalloc-Standardzuteilung ist fehlgeschlagen.
OLEUI_ERR_GLOBALMEMALLOC
 Fehler beim Aufruf von GlobalAlloc oder dem IMalloc-Standardzuteilungsmodul.
OLEUI_ERR_LOADSTRING
 LoadString kann nicht für lokalisierte Ressourcen aus der Bibliothek aufgerufen werden.
OLEUI_ERR_OLEMEMALLOC
 Fehler beim Aufruf des IMalloc-Standardzuteilungsmoduls.
 

Funktionsspezifische Fehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMAX
 Fehler, die allen Dialogfeldern gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.

Hinweise

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

IDD_LINKSOURCEUNAVAILABLE 
IDD_CANNOTUPDATELINK 
IDD_SERVERNOTREG 
IDD_CANNOTRESPONDVERB 
IDD_SERVERNOTFOUND

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oledlg.h
Bibliothek OleDlg.lib
DLL OleDlg.dll