URLAssociationDialogW, fonction (intshcut.h)

Article
11/20/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 précédemment inconnu.

Remarque 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 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 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 l’application est inscrite auprès du 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 ponctuelle via l’application sélectionnée.

Remarques

Note

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. 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