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

Article
08/25/2023

Modifie la source d’un lien.

Syntaxe

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR 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 de 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 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.

Notes

Notes 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é directement ou à partir de la boîte de dialogue Liens . Si cet appel à IOleUILinkContainer::SetLinkSource renvoie une erreur (par exemple, MkParseDisplayName a échoué parce que 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 convient de 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 évidence. 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 retourné à la boîte de dialogue Liens avec le lien marqué Indisponible.

Spécifications


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