IOleLink::GetSourceMoniker-Methode (oleidl.h)

  • Artikel

Ruft den Moniker ab, der die Linkquelle eines verknüpften Objekts identifiziert.

Syntax

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

Parameter

[out] ppmk

Adresse einer IMoniker-Zeigervariable , die den Schnittstellenzeiger auf einen absoluten Moniker empfängt, der die Linkquelle identifiziert. Bei erfolgreicher Implementierung muss AddRef für ppmk aufgerufen werden. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen. Wenn ein Fehler auftritt, muss die Implementierung ppmk auf NULL festlegen.

Rückgabewert

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

Rückgabecode Beschreibung
MK_E_UNAVAILABLE
 Kein Moniker ist verfügbar.

Hinweise

Hinweise für Anrufer

Ihre Containeranwendung kann IOleLink::GetSourceMoniker aufrufen, um die aktuelle Quelle eines Links im Dialogfeld Links anzuzeigen. Beachten Sie, dass Ihr Container dazu die IMoniker::GetDisplayName-Methode verwenden muss, um den Anzeigenamen des Monikers abzurufen. Wenn Sie den Anzeigenamen lieber direkt abrufen möchten, kann Ihr Container IOleLink::GetSourceDisplayName anstelle von IOleLink::GetSourceMoniker aufrufen.

Wenn Sie die OleUIEditLinks-Funktion zum Anzeigen des Dialogfelds Links verwenden, müssen Sie die IOleUILinkContainer-Schnittstelle implementieren. Das Dialogfeld ruft Ihre Implementierungen von IOleUILinkContainer::GetLinkSource auf, um die anzuzeigende Zeichenfolge abzurufen. Ihre Implementierung dieser Methode kann IOleLink::GetSourceMoniker aufrufen.

Hinweise zu Implementierern

Das verknüpfte Objekt speichert sowohl einen absoluten als auch einen relativen Moniker für die Linkquelle. Wenn der relative Moniker nicht NULL ist und ein Moniker für das zusammengesetzte Dokument verfügbar ist, gibt IOleLink::GetSourceMoniker den Moniker zurück, der durch Das Komponieren des relativen Monikers am Ende des Monikers des zusammengesetzten Dokuments erstellt wurde. Andernfalls wird der absolute Moniker oder, wenn ein Fehler auftritt, NULL zurückgegeben.

Der Container gibt den absoluten Moniker an, wenn er eine der OleCreateLink-Funktionen aufruft, um einen Link zu erstellen. Die Anwendung kann IOleLink::GetSourceMoniker oder IOleLink::GetSourceDisplayName aufrufen, um den absoluten Moniker zu ändern. Darüber hinaus aktualisiert das verknüpfte Objekt die Moniker automatisch, wenn es erfolgreich an die Linkquelle gebunden wird, oder wenn es an die Linkquelle gebunden ist und eine Umbenennungsbenachrichtigung über die IAdviseSink::OnRename-Methode empfängt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

IOleLink

IOleLink::GetSourceDisplayName

IOleLink::GetSourceMoniker