Metodo IOleUILinkContainerA::GetLinkSource (oledlg.h)

Articolo
03/05/2024

Recupera informazioni su un collegamento che può essere visualizzato nella finestra di dialogo Collegamenti .

Sintassi

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
);

Parametri

[in] dwLink

Identificatore univoco definito dal contenitore per un singolo collegamento. Vedere IOleUILinkContainer::GetNextLink.

[out, optional] lplpszDisplayName

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa nome visualizzato completo per l'origine del collegamento. La finestra di dialogo Collegamenti libera questa stringa.

[out] lplenFileName

Puntatore alla lunghezza della parte del nome del file iniziale della stringa lplpszDisplayName . Se l'origine del collegamento non è archiviata in un file, lplenFileName deve essere 0. Per i collegamenti OLE, chiamare IOleLink::GetSourceDisplayName.

[out, optional] lplpszFullLinkType

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di tipo di collegamento completo visualizzata nella parte inferiore della finestra di dialogo Collegamenti . Il chiamante alloca questa stringa. La finestra di dialogo Collegamenti libera questa stringa. Per i collegamenti OLE, deve essere il nome completo tipo utente. Usare IOleObject::GetUserType, specificando USERCLASSTYPE_FULL per dwFormOfType.

[out, optional] lplpszShortLinkType

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di tipo di collegamento breve visualizzata nella casella di riepilogo della finestra di dialogo Collegamenti . Il chiamante alloca questa stringa. La finestra di dialogo Collegamenti libera questa stringa. Per i collegamenti OLE, questo deve essere il nome di tipo utente breve. Usare IOleObject::GetUserType, specificando USERCLASSTYPE_SHORT per dwFormOfType.

[out] lpfSourceAvailable

Puntatore che restituisce FALSE se è noto che un collegamento non è disponibile poiché il collegamento è a un documento noto ma non disponibile. Alcune opzioni, ad esempio Update Now, sono disabilitate (disattivate nell'interfaccia utente) per tali casi.

[out] lpfIsSelected

Puntatore a una variabile che indica alla finestra di dialogo Modifica collegamenti che la voce del collegamento deve essere selezionata nella casella di riepilogo a selezione multipla della finestra di dialogo. OleUIEditLinks chiama questo metodo almeno una volta per ogni elemento da inserire nell'elenco di collegamenti. Se nessuno di essi restituisce TRUE, nessuno di essi verrà selezionato quando viene visualizzata la finestra di dialogo. Se tutti restituiscono TRUE, tutti verranno visualizzati. Vale a dire, restituisce TRUE se questo collegamento fa attualmente parte della selezione nel documento sottostante, FALSE se non. Tutti i collegamenti selezionati nel documento sottostante sono selezionati nella finestra di dialogo; in questo modo, l'utente può selezionare un set di collegamenti e usare la finestra di dialogo per aggiornarli o modificare contemporaneamente le origini.

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_ACCESSDENIED	Autorizzazioni di accesso insufficienti.
E_FAIL	Operazione non riuscita.
E_INVALIDARG	L'identificatore specificato non è valido.
E_OUTOFMEMORY	Per questa operazione è disponibile memoria insufficiente.

Commenti

Note ai chiamanti

Chiamare questo metodo durante l'inizializzazione della finestra di dialogo, dopo aver restituito dalla finestra di dialogo Change Source .

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	oledlg.h