Fonction SHStartNetConnectionDialogA (shlobj_core.h)

Article
03/04/2024

[SHStartNetConnectionDialog est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Affiche une boîte de dialogue de navigation générale pour une connexion de ressource réseau.

Syntaxe

SHSTDAPI SHStartNetConnectionDialogA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRemoteName,
                 DWORD  dwType
);

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente.

[in, optional] pszRemoteName

Type : LPCTSTR

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom du réseau distant. Cette valeur peut être définie sur NULL.

dwType

Type : DWORD

Champ de bits qui contient un ensemble d’indicateurs qui identifient le type de ressource que la boîte de dialogue est définie pour rechercher. Cette valeur peut contenir l’une des valeurs suivantes, définies dans Winnetwk.h :

RESOURCETYPE_ANY (0x00000000)

Toutes les ressources

RESOURCETYPE_DISK (0x00000001)

Ressources de disque

RESOURCETYPE_PRINT (0x00000002)

Imprimer des ressources

Valeur retournée

Type : HRESULT

Retourne toujours S_OK.

Remarques

Notes

L’en-tête shlobj_core.h définit SHStartNetConnectionDialog 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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h, Shlobj_core.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via