Fonction SHValidateUNC (shlobj_core.h)

Article
03/04/2024

[SHValidateUNC 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.]

Valide un chemin d’accès UNC (Universal Naming Convention) en appelant WNetAddConnection3. La fonction permet à l’utilisateur de taper une application UNC d’accès réseau à distance (RNA) ou un nom de document à partir de la boîte de dialogue Exécuter dans le menu Démarrer .

Syntaxe

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

Paramètres

[in, optional] hwndOwner

Type : HWND

Handle de la fenêtre parente, utilisé pour afficher l’interface utilisateur. Si cela n’est pas nécessaire, cette valeur peut être définie sur NULL.

[in, out] pszFile

Type : PWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie le chemin UNC à valider. Remarque : Cette chaîne ne doit pas être une chaîne constante.

fConnect

Type : UINT

Une ou plusieurs des valeurs suivantes.

VALIDATEUNC_CONNECT (0x0001)

Connecter une lettre de lecteur. Lorsque cet indicateur est défini, la valeur dans pszFile est remplacée par le lecteur local auquel l’UNC est mappé sur l’ordinateur local.

VALIDATEUNC_NOUI (0x0002)

En cas d’échec ou de réussite, n’affichez aucune interface utilisateur.

VALIDATEUNC_PRINT (0x0004)

Valider en tant que partage d’impression plutôt qu’en tant que partage de disque.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista et versions ultérieures. La connexion doit être rendue persistante.

VALIDATEUNC_VALID

Valeur de masque utilisée pour vérifier que les indicateurs passés à SHValidateUNC sont valides.

Valeur retournée

Type : BOOL

Retourne TRUE si le chemin UNC existe ; FALSE si le chemin UNC n’existe pas ou si un autre échec s’est produit.

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)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.00 ou ultérieure)

Partager via