Metodo IOleUILinkContainerW::SetLinkSource (oledlg.h)

Articolo
03/05/2024

Modifica l'origine di un collegamento.

Sintassi

HRESULT SetLinkSource(
  [in]  DWORD  dwLink,
  [in]  LPWSTR lpszDisplayName,
  [in]  ULONG  lenFileName,
  [out] ULONG  *pchEaten,
  [in]  BOOL   fValidateSource
);

Parametri

[in] dwLink

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

[in] lpszDisplayName

Puntatore alla nuova stringa di origine da analizzare.

[in] lenFileName

Lunghezza della parte iniziale del nome file della stringa lpszDisplayName . Se l'origine del collegamento non è archiviata in un file, lenFileName deve essere 0. Per i collegamenti OLE, chiamare IOleLink::GetSourceDisplayName.

[out] pchEaten

Puntatore al numero di caratteri analizzati correttamente in lpszDisplayName.

[in] fValidateSource

TRUE se il moniker deve essere convalidato; per i collegamenti OLE, è necessario chiamare MkParseDisplayName . FALSE se il moniker non deve essere convalidato. Se possibile, il collegamento deve accettare l'origine non convalidata e contrassegnarsi come non disponibile.

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	Memoria insufficiente disponibile per questa operazione.

Commenti

Note ai chiamanti

Chiamare questo metodo dalla finestra di dialogo Cambia origine , con fValidateSource inizialmente impostato su TRUE. È possibile chiamare l'origine delle modifiche direttamente o dalla finestra di dialogo Collegamenti. Se questa chiamata a IOleUILinkContainer::SetLinkSource restituisce un errore (ad esempio , MkParseDisplayName non è riuscito perché l'origine non è disponibile), dovrebbe essere visualizzato un messaggio di origine del collegamento non valido e l'utente deve essere autorizzato a decidere se correggere l'origine. Se l'utente sceglie di correggere l'origine, l'utente deve essere restituito alla finestra di dialogo Modifica origine con la parte non valida della stringa di input evidenziata. Se l'utente sceglie di non correggere l'origine, IOleUILinkContainer::SetLinkSource deve essere chiamato una seconda volta con fValidateSource impostato su FALSE e l'utente deve essere restituito alla finestra di dialogo Collegamenti con il collegamento contrassegnato come Non disponibile.

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

Vedi anche

IOleUILinkContainer

MkParseDisplayName

Condividi tramite