Fonction URLAssociationDialogA (intshcut.h)

Article
03/02/2024

Appelle la boîte de dialogue protocole d’URL non inscrite. Cette boîte de dialogue permet à l’utilisateur de sélectionner une application à associer à un protocole inconnu auparavant.

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

Syntaxe

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

Paramètres

hwndParent

Type : HWND

Handle de la fenêtre parente.

dwInFlags

Type : DWORD

Indicateurs de bits qui spécifient le comportement de la fonction. Cette valeur peut être une combinaison des éléments suivants :

URLASSOCDLG_FL_USE_DEFAULT_NAME

Utilisez le nom de fichier par défaut (autrement dit, « Raccourci Internet »).

URLASSOCDLG_FL_REGISTER_ASSOC

Inscrivez l’application sélectionnée comme gestionnaire pour le protocole spécifié dans pcszURL. L’application est inscrite uniquement si cet indicateur est défini et si l’utilisateur indique qu’une association persistante est souhaitée.

pcszFile

Type : PTCSTR

Adresse d’une chaîne sans fin constante qui contient le nom de fichier à associer au protocole URL.

pcszURL

Type : PTCSTR

Adresse d’une chaîne sans fin constante qui contient l’URL avec un protocole inconnu.

[out] pszAppBuf

Type : PTSTR

Adresse d’une mémoire tampon qui reçoit le chemin de l’application spécifiée par l’utilisateur.

ucAppBufLen

Type : UINT

Taille de pszAppBuf, en caractères.

Valeur retournée

Type : HRESULT

Note À 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 l’application est inscrite avec le protocole d’URL, ou S_FALSE si rien n’est inscrit. Par exemple, la fonction retourne S_FALSE lorsque l’utilisateur choisit d’effectuer une exécution ponctuelle via l’application sélectionnée.

Remarques

Notes

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

Partager via