Metodo IOleLink::SetSourceDisplayName (oleidl.h)
Imposta il nome visualizzato per l'origine del collegamento.
Sintassi
HRESULT SetSourceDisplayName(
[in] LPCOLESTR pszStatusText
);
Parametri
[in] pszStatusText
Puntatore al nome visualizzato della nuova origine del collegamento. Questo parametro non può essere NULL.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo.
I valori di MkParseDisplayName possono essere restituiti anche qui.
Commenti
Note ai chiamanti
L'applicazione contenitore può chiamare IOleLink::SetSourceDisplayName quando l'utente finale modifica l'origine di un collegamento o interrompe un collegamento. Si noti che questo richiede che l'oggetto collegato crei un moniker fuori dal nome visualizzato. Se si preferisce analizzare manualmente il nome visualizzato in un moniker, il contenitore può chiamare IOleLink::SetSourceMoniker anziché IOleLink::SetSourceDisplayName.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::SetLinkSource e IOleUILinkContainer::CancelLink. L'implementazione di questi metodi può chiamare IOleLink::SetSourceDisplayName.
Se l'applicazione contenitore esegue immediatamente il binding a un'origine di collegamento appena specificata, è necessario chiamare MkParseDisplayName e IOleLink::SetSourceMoniker e quindi chiamare IOleLink::BindToSource usando il contesto di associazione dall'operazione di analisi. Riutilizzando il contesto di associazione, è possibile evitare il caricamento ridondante di oggetti che altrimenti potrebbero verificarsi.
Note per gli implementatori
Il contratto per IOleLink::SetSourceDisplayName non specifica quando l'oggetto collegato analizzerà il nome visualizzato in un moniker. L'analisi può verificarsi prima che IOleLink::SetSourceDisplayName restituisca o l'oggetto collegato possa archiviare il nome visualizzato e analizzarlo solo quando deve essere associato all'origine del collegamento. Si noti che l'analisi del nome visualizzato è potenzialmente un'operazione costosa perché potrebbe richiedere l'associazione all'origine del collegamento. L'implementazione fornita di IOleLink::SetSourceDisplayName analizza il nome visualizzato e quindi rilascia il contesto di associazione usato nell'operazione di analisi. Ciò può comportare l'esecuzione e quindi l'arresto del server di origine del collegamento.Se l'oggetto collegato è associato all'origine del collegamento corrente, l'implementazione di IOleLink::SetSourceDisplayName interrompe la connessione.
Per altre informazioni su come l'oggetto collegato archivia e usa il moniker per l'origine del collegamento, vedere IOleLink::SetSourceMoniker.
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 |