Condividi tramite


Metodo IOleUILinkContainerA::SetLinkSource (oledlg.h)

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