OleUIChangeSourceA-Funktion (oledlg.h)
Ruft das Dialogfeld Quelle ändern auf, sodass der Benutzer die Quelle eines Links ändern kann.
Syntax
UINT OleUIChangeSourceA(
[in] LPOLEUICHANGESOURCEA unnamedParam1
);
Parameter
[in] unnamedParam1
Zeiger auf die in-out OLEUICHANGESOURCE-Struktur für dieses Dialogfeld.
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. |
|
Der LpOleUILinkContainer-Wert ist NULL. |
|
Der LpOleUILinkContainer-Wert ist ungültig. |
|
Der lpszFrom-Wert ist nicht NULL. |
|
Der lpszTo-Wert ist nicht NULL. |
|
Der LpszDisplayName- oder nFileLength-Wert ist ungültig oder kann die Linkquelle nicht abrufen. |
|
Der Wert nFilename ist falsch. |
Hinweise
Die Linkquelle wird nicht durch das Dialogfeld Quelle ändern selbst geändert. Stattdessen ist es Sache des Aufrufers, die Linkquelle mithilfe der zurückgegebenen Datei- und Elementzeichenfolgen zu ändern. Das Dialogfeld Links bearbeiten führt dies in der Regel für den Aufrufer aus.
Hinweis
Der oledlg.h-Header definiert OLEUICHANGESOURCE 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 |