Fonction URLAssociationDialogW (intshcut.h)

Article
08/24/2023

Appelle la boîte de dialogue Protocole d’URL non enregistrée. Cette boîte de dialogue permet à l’utilisateur de sélectionner une application à associer à un protocole précédemment inconnu.

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

Syntaxe

INTSHCUTAPI HRESULT URLAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszURL,
  [out] PWSTR  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 en tant que gestionnaire pour le protocole spécifié dans pcszURL. L’application est inscrite uniquement si cet indicateur est défini et que l’utilisateur indique qu’une association persistante est souhaitée.

pcszFile

Type : PTCSTR

Adresse d’une chaîne à terminaison zéro constante qui contient le nom de fichier à associer au protocole URL.

pcszURL

Type : PTCSTR

Adresse d’une chaîne à terminaison zéro 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 Depuis 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 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 unique via l’application sélectionnée.

Notes

L’en-tête intshcut.h définit URLAssociationDialog en tant qu’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. La combinaison 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


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