Méthode IOleUILinkContainerW ::SetLinkSource (oledlg.h)

Article
03/04/2024

Modifie la source d’un lien.

Syntaxe

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

Paramètres

[in] dwLink

Identificateur unique défini par le conteneur pour un lien unique. Consultez IOleUILinkContainer ::GetNextLink.

[in] lpszDisplayName

Pointeur vers la nouvelle chaîne source à analyser.

[in] lenFileName

Longueur de la partie du nom de fichier de début de la chaîne lpszDisplayName . Si la source du lien n’est pas stockée dans un fichier, lenFileName doit avoir la valeur 0. Pour les liens OLE, appelez IOleLink ::GetSourceDisplayName.

[out] pchEaten

Pointeur vers le nombre de caractères correctement analysés dans lpszDisplayName.

[in] fValidateSource

TRUE si le moniker doit être validé ; pour les liens OLE, MkParseDisplayName doit être appelé. FALSE si le moniker ne doit pas être validé. Si possible, le lien doit accepter la source non valide et se marquer comme étant indisponible.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_ACCESSDENIED	Autorisations d’accès insuffisantes.
E_FAIL	L'opération a échoué.
E_INVALIDARG	L’identificateur fourni n’est pas valide.
E_OUTOFMEMORY	Mémoire insuffisante disponible pour cette opération.

Remarques

Remarques aux appelants

Appelez cette méthode à partir de la boîte de dialogue Modifier la source , avec fValidateSource initialement défini sur TRUE. Modifier la source peut être appelée directement ou à partir de la boîte de dialogue Liens . Si cet appel à IOleUILinkContainer ::SetLinkSource renvoie une erreur (par exemple, MkParseDisplayName a échoué car la source n’était pas disponible), vous devez afficher un message Source de lien non valide et l’utilisateur doit être autorisé à décider s’il faut corriger la source. Si l’utilisateur choisit de corriger la source, l’utilisateur doit être retourné à la boîte de dialogue Modifier la source avec la partie non valide de la chaîne d’entrée mise en surbrillance. Si l’utilisateur choisit de ne pas corriger la source, IOleUILinkContainer ::SetLinkSource doit être appelé une deuxième fois avec fValidateSource défini sur FALSE, et l’utilisateur doit être renvoyé à la boîte de dialogue Liens avec le lien marqué Indisponible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oledlg.h

Voir aussi

IOleUILinkContainer

MkParseDisplayName

Partager via