Metodo IOleUILinkContainerA::SetLinkSource (oledlg.h)

Articolo
08/25/2023

Modifica l'origine di un collegamento.

Sintassi

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR 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 del nome del file iniziale 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 analizzato 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 Change Source , con fValidateSource inizialmente impostato su TRUE. Modifica origine può essere chiamato 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), è necessario visualizzare un messaggio di origine 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


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