Metodo IOleLink::GetSourceDisplayName (oleidl.h)

Articolo
03/01/2024

Recupera il nome visualizzato dell'origine collegamento dell'oggetto collegato.

Sintassi

HRESULT GetSourceDisplayName(
  [out] LPOLESTR *ppszDisplayName
);

Parametri

[out] ppszDisplayName

Indirizzo di una variabile puntatore che riceve un puntatore al nome visualizzato dell'origine del collegamento. Se si verifica un errore, ppszDisplayName è impostato su NULL; in caso contrario, l'implementazione deve usare IMalloc::Alloc per allocare la stringa restituita in ppszDisplayName e il chiamante è responsabile della chiamata AMalloc::Free per liberarlo. Chiamante e chiamante usano l'allocatore restituito da CoGetMalloc.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.

Il recupero del nome visualizzato richiede la chiamata di queste funzioni; pertanto, questo metodo può restituire errori generati da CreateBindCtx e IMoniker::GetDisplayName.

Commenti

Note ai chiamanti

L'applicazione contenitore può chiamare IOleLink::GetSourceDisplayName per visualizzare l'origine corrente di un collegamento.

L'origine corrente di un collegamento viene visualizzata nella finestra di dialogo Collegamenti . Se si usa la funzione OleUIEditLinks per visualizzare la finestra di dialogo Collegamenti , è necessario implementare l'interfaccia IOleUILinkContainer . La finestra di dialogo chiama le implementazioni di IOleUILinkContainer::GetLinkSource per ottenere la stringa visualizzata. L'implementazione di tale metodo può chiamare IOleLink::GetSourceDisplayName.

Note per gli implementatori

L'implementazione dell'oggetto collegato di IOleLink::GetSourceDisplayName chiama IOleLink::GetSourceMoniker per ottenere il moniker di origine del collegamento e quindi chiama IMoniker::GetDisplayName per ottenere il nome visualizzato del moniker. Questa operazione è potenzialmente costosa perché potrebbe richiedere l'associazione del moniker. Tutti i moniker forniti dal sistema possono restituire un nome visualizzato senza associazione, ma non esiste alcuna garanzia che altre implementazioni moniker possano. Anziché effettuare chiamate ripetute a IOleLink::GetSourceDisplayName, l'applicazione contenitore può memorizzare nella cache il nome e aggiornarla ogni volta che l'origine del collegamento è associata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h