OleUIChangeSourceA, fonction (oledlg.h)

Article
11/20/2024

Appelle la boîte de dialogue Modifier la source, ce qui permet à l’utilisateur de modifier la source d’un lien.

Syntaxe

UINT OleUIChangeSourceA(
  [in] LPOLEUICHANGESOURCEA unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers la structure OLEUICHANGE SOURCE in-out pour cette boîte de dialogue.

Valeur de retour

Définitions de réussite/d’erreur standard

Retourner le code	Description
OLEUI_FALSE	Échec inconnu (inutilisé).
OLEUI_OK	L’utilisateur a appuyé sur le bouton OK.
OLEUI_SUCCESS	Aucune erreur, identique à OLEUI_OK.
OLEUI_CANCEL	L’utilisateur a appuyé sur le bouton Annuler.

Erreurs de validation de champ standard

Retourner le code	Description
OLEUI_ERR_STANDARDMIN	Les erreurs courantes dans toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_ERR_STRUCTURENULL	Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL.
OLEUI_ERR_STRUCTUREINVALID	Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	La valeur cbstruct est incorrecte.
OLEUI_ERR_HWNDOWNERINVALID	La valeur hWndOwner n’est pas valide.
OLEUI_ERR_LPSZCAPTIONINVALID	La valeur lpszCaption n’est pas valide.
OLEUI_ERR_LPFNHOOKINVALID	La valeur lpfnHook n’est pas valide.
OLEUI_ERR_HINSTANCEINVALID	La valeur hInstance n’est pas valide.
OLEUI_ERR_LPSZTEMPLATEINVALID	La valeur lpszTemplate n’est pas valide.
OLEUI_ERR_HRESOURCEINVALID	La valeur hResource n’est pas valide.

Erreurs d’initialisation

Retourner le code	Description
OLEUI_ERR_FINDTEMPLATEFAILURE	Impossible de trouver le modèle de boîte de dialogue.
OLEUI_ERR_LOADTEMPLATEFAILURE	Impossible de charger le modèle de boîte de dialogue.
OLEUI_ERR_DIALOGFAILURE	Échec de l’initialisation de la boîte de dialogue.
OLEUI_ERR_LOCALMEMALLOC	Un appel à localAlloc ou au IMalloc standard allocator a échoué.
OLEUI_ERR_GLOBALMEMALLOC	Un appel à GlobalAlloc ou au IMalloc standard allocator a échoué.
OLEUI_ERR_LOADSTRING	Impossible d’appeler LoadString pour les ressources localisées à partir de la bibliothèque.
OLEUI_ERR_OLEMEMALLOC	Un appel à la norme IMalloc allocator a échoué.

Erreurs spécifiques à la fonction

Retourner le code	Description
OLEUI_ERR_STANDARDMAX	Les erreurs courantes dans toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_CSERR_LINKCNTRNULL	La valeur lpOleUILinkContainer est NULL.
OLEUI_CSERR_LINKCNTRINVALID	La valeur lpOleUILinkContainer n’est pas valide.
OLEUI_CSERR_FROMNOTNULL	La valeur lpszFrom n’est pas NULL.
OLEUI_CSERR_TONOTNULL	La valeur lpszTo n’est pas NULL .
OLEUI_CSERR_SOURCEINVALID	La valeur lpszDisplayName ou nFileLength n’est pas valide ou ne peut pas récupérer la source du lien.
OLEUI_CSERR_SOURCEPARSEERROR	La valeur nFilename est incorrecte.

Remarques

La source de lien n’est pas modifiée par la boîte de dialogue Modifier la source elle-même. Au lieu de cela, il incombe à l’appelant de modifier la source de lien à l’aide des chaînes de fichier et d’élément retournées. La boîte de dialogue Modifier les liens le fait généralement pour l’appelant.

Note

L’en-tête oledlg.h définit OLEUICHANGESOURCE comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	oledlg.h
bibliothèque	OleDlg.lib
DLL	OleDlg.dll

Voir aussi

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks

Partager via