OleUIChangeIconA, fonction (oledlg.h)
Appelle la boîte de dialogue Modifier l’icône standard, qui permet à l’utilisateur de sélectionner une icône à partir d’un fichier d’icône, d’un fichier exécutable ou d’une DLL.
Syntaxe
UINT OleUIChangeIconA(
[in] LPOLEUICHANGEICONA unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers la structure In/Out OLEUICHANGEICON pour cette boîte de dialogue.
Valeur retournée
Définitions de réussite/erreur standard
Code de retour | Description |
---|---|
|
Échec inconnu (inutilisé). |
|
L’utilisateur a appuyé sur le bouton OK. |
|
Aucune erreur, identique à OLEUI_OK. |
|
L’utilisateur a appuyé sur le bouton Annuler. |
Erreurs de validation de champ standard
Code de retour | Description |
---|---|
|
Les erreurs communes à 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. |
|
Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL. |
|
Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX. |
|
La valeur cbstruct est incorrecte. |
|
La valeur hWndOwner n’est pas valide. |
|
La valeur lpszCaption n’est pas valide. |
|
La valeur lpfnHook n’est pas valide. |
|
La valeur hInstance n’est pas valide. |
|
La valeur lpszTemplate n’est pas valide. |
|
La valeur hResource n’est pas valide. |
Erreurs d’initialisation
Code de retour | Description |
---|---|
|
Impossible de trouver le modèle de boîte de dialogue. |
|
Impossible de charger le modèle de boîte de dialogue. |
|
Échec de l’initialisation de la boîte de dialogue. |
|
Un appel à LocalAlloc ou à l’allocateur IMalloc standard a échoué. |
|
Un appel à GlobalAlloc ou à l’allocator IMalloc standard a échoué. |
|
Impossible d’appeler LoadString pour les ressources localisées à partir de la bibliothèque. |
|
Un appel à l’allocator IMalloc standard a échoué. |
Erreurs spécifiques à la fonction
Code de retour | Description |
---|---|
|
Les erreurs communes à 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. |
|
Le membre clsid n’était pas le CLSID actuel. |
|
Le membre hMetaPict n’était pas le métafichier actuel. |
|
La valeur szIconExe n’était pas valide. |
Remarques
Notes
L’en-tête oledlg.h définit OLEUICHANGEICON comme un 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.
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 |
Bibliothèque | OleDlg.lib |
DLL | OleDlg.dll |