MIMEAssociationDialogA, fonction (intshcut.h)

Article
11/20/2024

Exécute la boîte de dialogue type de contenu MIME non inscrit.

Remarque Windows XP Service Pack 2 (SP2) ou version ultérieure : cette fonction n’est plus prise en charge.

Syntaxe

INTSHCUTAPI HRESULT MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Paramètres

hwndParent

Type : HWND

Handle vers la fenêtre parente de toutes les fenêtres enfants publiées.

dwInFlags

Type : DWORD

Valeur d’indicateur de bits qui spécifie si une association doit être inscrite. L’indicateur de bits est la valeur MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Si ce bit est défini, l’application sélectionnée est inscrite en tant que gestionnaire pour le type MIME donné. Si ce bit est clair, aucune association n’est inscrite.

Une application est inscrite uniquement si cet indicateur est défini et que l’utilisateur indique qu’une association persistante doit être établie.

L’inscription est impossible si la chaîne à pcszFile ne contient pas d’extension.

pcszFile

Type : PCTSTR

Adresse d’une chaîne terminée par null qui contient le nom du fichier cible. Ce fichier doit être conforme au type de contenu décrit par le paramètre pcszMIMEContentType.

pcszMIMEContentType

Type : PCTSTR

Adresse d’une chaîne terminée par null qui contient le type de contenu non inscrit.

[out] pszAppBuf

Type : PTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit le chemin d’accès de l’application spécifiée par l’utilisateur.

ucAppBufLen

Type : uiNT

Taille de pszAppBuf, en caractères.

Valeur de retour

Type : HRESULT

Remarque à partir de Windows XP SP2, cette fonction n’est pas prise en charge et retourne E_NOTIMPL dans toutes les situations.

Dans les systèmes pris en charge, retourne S_OK si le type de contenu a été correctement associé à l’extension. Dans ce cas, l’extension est associée comme valeur par défaut pour le type de contenu, et pszAppBuf pointe vers la chaîne qui contient le chemin d’accès de l’application spécifiée. La fonction retourne S_FALSE si rien n’a été inscrit. Sinon, la valeur de retour sera l’une des suivantes :

Retourner le code	Description
E_ABORT	L’utilisateur a annulé l’opération.
E_FLAGS	La combinaison d’indicateurs passée dans dwInFlags n’est pas valide.
E_OUTOFMEMORY	La mémoire disponible était insuffisante pour terminer l’opération.
E_POINTER	L’un des pointeurs d’entrée n’est pas valide.

Remarques

Cette fonction ne valide pas la syntaxe de la chaîne de type de contenu d’entrée à pcszMIMEContentType. Une valeur de retour réussie n’indique pas que le type de contenu MIME spécifié est valide.

Note

L’en-tête intshcut.h définit MIMEAssociationDialog 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 XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	intshcut.h
DLL	Url.dll

Partager via