Freigeben über


OleUIChangeIconA-Funktion (oledlg.h)

Ruft das Standarddialogfeld Symbol ändern auf, in dem der Benutzer ein Symbol aus einer Symboldatei, ausführbaren Datei oder DLL auswählen kann.

Syntax

UINT OleUIChangeIconA(
  [in] LPOLEUICHANGEICONA unnamedParam1
);

Parameter

[in] unnamedParam1

Zeiger auf die OLEUICHANGEICON-Struktur für dieses Dialogfeld.

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.
OLEUI_CIERR_MUSTHAVECLSID
Der clsid-Member war nicht die aktuelle CLSID.
OLEUI_CIERR_MUSTHAVECURRENTMETAFILE
Das hMetaPict-Element war nicht die aktuelle Metadatei.
OLEUI_CIERR_SZICONEXEINVALID
Der szIconExe-Wert war ungültig.

Hinweise

OLEUICHANGEICON-Struktur .

Hinweis

Der oledlg.h-Header definiert OLEUICHANGEICON als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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

Weitere Informationen

OLEUICHANGEICON