Share via

OleUIChangeSourceW-Funktion (oledlg.h)

  • Artikel

Ruft das Dialogfeld Quelle ändern auf, sodass der Benutzer die Quelle eines Links ändern kann.

Syntax

UINT OleUIChangeSourceW(
  [in] LPOLEUICHANGESOURCEW unnamedParam1
);

Parameter

[in] unnamedParam1

Zeiger auf die in diesem Dialogfeld enthaltene OLEUICHANGESOURCE-Struktur .

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, wie OLEUI_OK.
OLEUI_CANCEL
 Der Benutzer hat die Schaltfläche Abbrechen gedrückt.
 

Standardfeldvalidierungsfehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMIN
 Fehler, die für alle Dialogfelder 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-Standardzuweisung ist fehlgeschlagen.
OLEUI_ERR_GLOBALMEMALLOC
 Fehler beim Aufruf von GlobalAlloc oder der IMalloc-Standardzuweisung .
OLEUI_ERR_LOADSTRING
 LoadString für lokalisierte Ressourcen aus der Bibliothek kann nicht aufgerufen werden.
OLEUI_ERR_OLEMEMALLOC
 Fehler beim Aufruf der IMalloc-Standardzuweisung .
 

Funktionsspezifische Fehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMAX
 Fehler, die für alle Dialogfelder 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_CSERR_LINKCNTRNULL
 Der LpOleUILinkContainer-Wert ist NULL.
OLEUI_CSERR_LINKCNTRINVALID
 Der LpOleUILinkContainer-Wert ist ungültig.
OLEUI_CSERR_FROMNOTNULL
 Der LpszFrom-Wert ist nicht NULL.
OLEUI_CSERR_TONOTNULL
 Der lpszTo-Wert ist nicht NULL.
OLEUI_CSERR_SOURCEINVALID
 Der Wert lpszDisplayName oder nFileLength ist ungültig oder kann die Linkquelle nicht abrufen.
OLEUI_CSERR_SOURCEPARSEERROR
 Der nFilename-Wert ist falsch.

Hinweise

Die Linkquelle wird durch das Dialogfeld Quelle ändern selbst nicht geändert. Stattdessen ist es Sache des Aufrufers, die Linkquelle mithilfe der zurückgegebenen Datei- und Elementzeichenfolgen zu ändern. Im Dialogfeld Verknüpfungen bearbeiten wird dies in der Regel für den Aufrufer erledigt.

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 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
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

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks