NetUseGetInfo, fonction (lmuse.h)

Article
08/24/2023

La fonction NetUseGetInfo récupère des informations sur une connexion à une ressource partagée.

Vous pouvez également utiliser la fonction WNetGetConnection pour récupérer le nom d’une ressource réseau associée à un appareil local.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Paramètres

[in] UncServerName

Nom UNC de l’ordinateur sur lequel exécuter cette fonction. S’il s’agit d’un paramètre NULL, l’ordinateur local est utilisé. Si le paramètre UncServerName spécifié est un ordinateur distant, l’ordinateur distant doit prendre en charge les appels RPC distants à l’aide du mécanisme hérité du protocole d’accès à distance.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

[in] UseName

Pointeur vers une chaîne qui spécifie le nom de la connexion pour laquelle retourner des informations.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

[in] LevelFlags

Niveau d’informations des données demandées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0	Spécifie un nom d’appareil local et le nom de partage d’une ressource distante. Le paramètre BufPtr est un pointeur vers une structure USE_INFO_0 .
1	Spécifie des informations sur la connexion entre un appareil local et une ressource partagée, y compris la status de connexion et le type. Le paramètre BufPtr est un pointeur vers une structure USE_INFO_1 .
2	Spécifie des informations sur la connexion entre un appareil local et une ressource partagée. Les informations incluent le status de connexion, le type de connexion, le nom d’utilisateur et le nom de domaine. Le paramètre BufPtr est un pointeur vers une structure USE_INFO_2 .

[out] bufptr

Pointeur vers la mémoire tampon qui reçoit les données. Le format de ces données dépend de la valeur du paramètre Level . Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Notes

Aucune appartenance à un groupe spécial n’est requise pour appeler la fonction NetUseGetInfo . Cette fonction ne peut pas être exécutée sur un serveur distant, sauf en cas de compatibilité de niveau inférieur.

Pour répertorier toutes les connexions actuelles entre l’ordinateur local et les ressources sur les serveurs distants, vous pouvez appeler la fonction NetUseEnum .

Cette fonction s’applique uniquement au client Server Message Block (LAN Manager Workstation). La fonction NetUseGetInfo ne prend pas en charge les partages DFS (Distributed File System). Pour récupérer des informations pour un partage à l’aide d’un autre fournisseur réseau (WebDAV ou un partage DFS, par exemple), utilisez la fonction WNetGetConnection .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmuse.h (inclure Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll