Metodo IOleLink::GetSourceMoniker (oleidl.h)
Recupera il moniker che identifica l'origine collegamento di un oggetto collegato.
Sintassi
HRESULT GetSourceMoniker(
[out] IMoniker **ppmk
);
Parametri
[out] ppmk
Indirizzo di una variabile puntatore IMoniker che riceve il puntatore dell'interfaccia a un moniker assoluto che identifica l'origine collegamento. In caso di esito positivo, l'implementazione deve chiamare AddRef on ppmk; è responsabilità del chiamante chiamare Release. Se si verifica un errore, l'implementazione deve impostare ppmk su NULL.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Non è disponibile alcun moniker. |
Commenti
Note ai chiamanti
L'applicazione contenitore può chiamare IOleLink::GetSourceMoniker per visualizzare l'origine corrente di un collegamento nella finestra di dialogo Collegamenti . Si noti che questo richiede al contenitore di usare il metodo IMoniker::GetDisplayName per ottenere il nome visualizzato del moniker. Se si preferisce ottenere direttamente il nome visualizzato, il contenitore può chiamare IOleLink::GetSourceDisplayName anziché IOleLink::GetSourceMoniker.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::GetSourceMoniker.
Note per gli implementatori
L'oggetto collegato archivia sia un moniker assoluto che un moniker relativo per l'origine collegamento. Se il moniker relativo non è NULL e un moniker è disponibile per il documento composto, IOleLink::GetSourceMoniker restituisce il moniker creato componendo il moniker relativo alla fine del moniker del documento composto. In caso contrario, restituisce il moniker assoluto o, se si verifica un errore, NULL.Il contenitore specifica il moniker assoluto quando chiama una delle funzioni OleCreateLink per creare un collegamento. L'applicazione può chiamare IOleLink::GetSourceMoniker o IOleLink::GetSourceDisplayName per modificare il moniker assoluto. Inoltre, l'oggetto collegato aggiorna automaticamente i moniker ogni volta che associa correttamente all'origine del collegamento o quando è associato all'origine del collegamento e riceve una notifica di ridenominazione tramite il metodo IAdviseSink::OnRename .
Requisiti
| 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 |