OleUIConvertA-Funktion (oledlg.h)
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
Zeiger auf eine OLEUICONVERT-Struktur , die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden.
Rückgabewert
Standarddefinitionen für Erfolg/Fehler
| Rückgabecode | Beschreibung |
|---|---|
|
Unbekannter Fehler (nicht verwendet). |
|
Der Benutzer hat die Schaltfläche OK gedrückt. |
|
Kein Fehler, identisch mit OLEUI_OK. |
|
Der Benutzer hat die Schaltfläche Abbrechen gedrückt. |
Standardfeldüberprüfungsfehler
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wurde, war NULL. |
|
Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur. |
|
Der cbstruct-Wert ist falsch. |
|
Der hWndOwner-Wert ist ungültig. |
|
Der lpszCaption-Wert ist ungültig. |
|
Der lpfnHook-Wert ist ungültig. |
|
Der hInstance-Wert ist ungültig. |
|
Der lpszTemplate-Wert ist ungültig. |
|
Der hResource-Wert ist ungültig. |
Initialisierungsfehler
| Rückgabecode | Beschreibung |
|---|---|
|
Die Dialogfeldvorlage konnte nicht gefunden werden. |
|
Die Dialogfeldvorlage kann nicht geladen werden. |
|
Fehler bei der Dialogfeldinitialisierung. |
|
Ein Aufruf von LocalAlloc oder der IMalloc-Standardzuteilung ist fehlgeschlagen. |
|
Fehler beim Aufruf von GlobalAlloc oder dem IMalloc-Standardzuteilungsmodul. |
|
LoadString kann nicht für lokalisierte Ressourcen aus der Bibliothek aufgerufen werden. |
|
Fehler beim Aufruf des IMalloc-Standardzuteilungsmoduls. |
Funktionsspezifische Fehler
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
Ein clsid-Wert war ungültig. |
|
Der wert dvAspect war ungültig. Dieses Element gibt den Aspekt des -Objekts an. |
|
Der wFormat-Wert war ungültig. Dieses Element gibt das Datenformat des -Objekts an. |
|
Ein Zeichenfolgenwert (z. B. lpszUserType oder lpszDefLabel) war ungültig. |
Hinweise
OleUIConvert füllt das Listenfeld des Dialogfelds Konvertieren mit Objektklassen, indem die Registrierung durchläuft und nach Einträgen in den Schlüsseln Lesbar und ReadWritable gesucht wird. Jede Klasse, die das Standarddateiformat der ursprünglichen Klasse in ihrem lesbaren Schlüssel enthält, wird der Liste Convert hinzugefügt, und jede Klasse, die das Standarddateiformat der ursprünglichen Klasse in ihrem ReadWritable-Schlüssel enthält, wird der Liste Activate As hinzugefügt. Die Liste Konvertieren wird im Listenfeld des Dialogfelds angezeigt, wenn das Optionsfeld Konvertieren ausgewählt ist (die Standardauswahl), und die Liste Aktivieren als wird angezeigt, wenn Aktivieren als 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 Convert-Befehl, der diese Funktion aufruft, sollte nur für den Benutzer verfügbar gemacht werden, wenn OleUICanConvertOrActivateAs S_OK zurückgibt.
Hinweis
Der oledlg.h-Header definiert OLEUICONVERT 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 |