IOleUILinkContainerA::GetLinkSource-Methode (oledlg.h)

Artikel
03/01/2024

Ruft Informationen zu einem Link ab, die im Dialogfeld Links angezeigt werden können.

Syntax

HRESULT GetLinkSource(
  [in]            DWORD dwLink,
  [out, optional] LPSTR *lplpszDisplayName,
  [out]           ULONG *lplenFileName,
  [out, optional] LPSTR *lplpszFullLinkType,
  [out, optional] LPSTR *lplpszShortLinkType,
  [out]           BOOL  *lpfSourceAvailable,
  [out]           BOOL  *lpfIsSelected
);

Parameter

[in] dwLink

Containerdefinierter eindeutiger Bezeichner für einen einzelnen Link. Siehe IOleUILinkContainer::GetNextLink.

[out, optional] lplpszDisplayName

Adresse einer Zeigervariable, die einen Zeiger auf die vollständige Anzeigenamenzeichenfolge für die Linkquelle empfängt. Im Dialogfeld Links wird diese Zeichenfolge freigegeben.

[out] lplenFileName

Zeiger auf die Länge des führenden Dateinamenteils der lplpszDisplayName-Zeichenfolge . Wenn die Linkquelle nicht in einer Datei gespeichert ist, sollte lplenFileName 0 sein. Rufen Sie für OLE-Links IOleLink::GetSourceDisplayName auf.

[out, optional] lplpszFullLinkType

Adresse einer Zeigervariable, die einen Zeiger auf die vollständige Linktypzeichenfolge empfängt, die unten im Dialogfeld Links angezeigt wird. Der Aufrufer weist diese Zeichenfolge zu. Im Dialogfeld Links wird diese Zeichenfolge freigegeben. Bei OLE-Links sollte dies der vollständige Benutzername sein. Verwenden Sie IOleObject::GetUserType, und geben Sie USERCLASSTYPE_FULL für dwFormOfType an.

[out, optional] lplpszShortLinkType

Adresse einer Zeigervariable, die einen Zeiger auf die kurzlinktypzeichenfolge empfängt, die im Listenfeld des Dialogfelds Links angezeigt wird. Der Aufrufer weist diese Zeichenfolge zu. Im Dialogfeld Links wird diese Zeichenfolge freigegeben. Bei OLE-Links sollte dies der kurze Benutzername sein. Verwenden Sie IOleObject::GetUserType, und geben Sie USERCLASSTYPE_SHORT für dwFormOfType an.

[out] lpfSourceAvailable

Zeiger, der FALSE zurückgibt, wenn bekannt ist, dass ein Link nicht verfügbar ist, da der Link zu einem bekannten, aber nicht verfügbaren Dokument ist. Bestimmte Optionen, z. B . Jetzt aktualisieren, sind für solche Fälle deaktiviert (in der Benutzeroberfläche abgeblendet).

[out] lpfIsSelected

Zeiger auf eine Variable, die dem Dialogfeld Links bearbeiten mitteilt, dass der Eintrag dieses Links im Listenfeld für die Mehrfachauswahl des Dialogfelds ausgewählt werden soll. OleUIEditLinks ruft diese Methode mindestens einmal für jedes Element auf, das in der Linkliste platziert werden soll. Wenn keiner von ihnen TRUE zurückgibt, wird keiner von ihnen ausgewählt, wenn das Dialogfeld zum ersten Mal angezeigt wird. Wenn alle true zurückgeben, werden alle angezeigt. Das heißt, es gibt TRUE zurück, wenn dieser Link derzeit Teil der Auswahl im zugrunde liegenden Dokument ist, FALSE , falls nicht. Alle Links, die im zugrunde liegenden Dokument ausgewählt sind, werden im Dialogfeld ausgewählt. Auf diese Weise kann der Benutzer eine Reihe von Links auswählen und das Dialogfeld verwenden, um sie gleichzeitig zu aktualisieren oder seine Quelle(en) zu ändern.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_ACCESSDENIED	Unzureichende Zugriffsberechtigungen.
E_FAIL	Fehler beim Vorgang.
E_INVALIDARG	Der angegebene Bezeichner ist ungültig.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Hinweise für Anrufer

Rufen Sie diese Methode während der Dialogfeldinitialisierung auf, nachdem Sie aus dem Dialogfeld Quelle ändern zurückgegeben haben.

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