Freigeben über

OleUIConvertA-Funktion (oledlg.h)

  • Artikel

Ruft das Standarddialogfeld Konvertieren auf, sodass der Benutzer den Typ eines einzelnen angegebenen Objekts oder den Typ aller OLE-Objekte der Klasse des angegebenen Objekts ändern kann.

Syntax

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

Parameter

[in] unnamedParam1

Zeigen Sie auf eine OLEUICONVERT- Struktur, die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet 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.
OLEUI_CTERR_CLASSIDINVALID
 Ein clsid- Wert war ungültig.
OLEUI_CTERR_DVASPECTINVALID
 Der wert dvAspect war ungültig. Dieses Element gibt den Aspekt des Objekts an.
OLEUI_CTERR_CBFORMATINVALID
 Der wFormat- Wert war ungültig. Dieses Element gibt das Datenformat des Objekts an.
OLEUI_CTERR_STRINGINVALID
 Ein Zeichenfolgenwert (z. B. lpszUserType oder lpszDefLabel) war ungültig.

Bemerkungen

OleUIConvert füllt das Listenfeld des Dialogfelds Konvertieren mit Objektklassen auf, indem die Registrierung durchlaufen und nach Einträgen in den lesbaren und schreibbaren Schlüsseln gesucht wird. Jede Klasse, die das Standarddateiformat der ursprünglichen Klasse in seinem lesbaren Schlüssel enthält, wird der Liste "Konvertieren" hinzugefügt, und jede Klasse, die das Standarddateiformat der ursprünglichen Klasse enthält, wird der Liste "Aktivieren unter" hinzugefügt. Die Liste "Konvertieren" wird im Listenfeld des Dialogfelds angezeigt, wenn das Optionsfeld " konvertieren" ausgewählt ist (Standardauswahl), und die Liste "Aktivieren unter" wird angezeigt, wenn "Als aktivieren" ausgewählt ist.

Beachten Sie, dass Sie den Typ aller Objekte einer bestimmten Klasse nur ändern können, wenn CF_CONVERTONLY nicht angegeben ist.

Der Konvertierungsbefehl, der diese Funktion aufruft, sollte dem Benutzer nur zur Verfügung gestellt werden, wenn OleUICanConvertOrActivateAs S_OK zurückgibt.

Anmerkung

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

OLEUICONVERT-

OleUICanConvertOrActivateAs