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
Zeigen Sie auf die in-out-OLEUICHANGESOURCE- Struktur für dieses Dialogfeld.
Rückgabewert
Standard-Erfolgs-/Fehlerdefinitionen
| 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 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. |
|
Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wird, war NULL-. |
|
Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur. |
|
Der wert cbstruct 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 wert lpszTemplate 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 Initialisierung des Dialogfelds. |
|
Fehler beim Aufruf LocalAlloc- oder des Standard-IMalloc Allocator. |
|
Fehler beim Aufruf von GlobalAlloc oder der Standard-IMalloc Allocator. |
|
LoadString kann nicht für lokalisierte Ressourcen aus der Bibliothek aufgerufen werden. |
|
Fehler beim Aufruf des Standard-IMalloc Allocator. |
Funktionsspezifische Fehler
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
Der lpOleUILinkContainer- Wert ist NULL-. |
|
Der lpOleUILinkContainer- Wert ist ungültig. |
|
Der wert lpszFrom ist nicht NULL-. |
|
Der wert lpszTo ist nicht NULL-. |
|
Der wert lpszDisplayName oder nFileLength ist ungültig oder kann die Verknüpfungsquelle nicht abrufen. |
|
Der nFilename Wert ist falsch. |
Bemerkungen
Die Verknüpfungsquelle wird nicht durch das Dialogfeld ändern selbst geändert. Stattdessen liegt es bei dem Aufrufer, die Linkquelle mithilfe der zurückgegebenen Datei- und Elementzeichenfolgen zu ändern. Das Dialogfeld Verknüpfungen bearbeiten führt dies normalerweise für den Aufrufer aus.
Anmerkung
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 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 |