structure USE_INFO_2 (lmuse.h)

  • Article

La structure USE_INFO_2 contient des informations sur une connexion entre un ordinateur local et une ressource partagée, notamment le type de connexion, le status de connexion, le nom d’utilisateur et le nom de domaine.

Syntaxe

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Membres

ui2_local

Type : LMSTR

Pointeur vers une chaîne qui contient le nom de l’appareil local (par exemple, le lecteur E ou LPT1) redirigé vers la ressource partagée. La constante DEVLEN spécifie le nombre maximal de caractères dans la chaîne. Ce membre peut avoir la valeur NULL. Pour plus d'informations, consultez la section Notes qui suit.

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

ui2_remote

Type : LMSTR

Pointeur vers une chaîne qui contient le nom de partage de la ressource distante. La chaîne est au format

\\servername\sharename

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

ui2_password

Type : LMSTR

Pointeur vers une chaîne qui contient le mot de passe nécessaire pour établir une session avec une station de travail spécifique.

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

ui2_status

Type : DWORD

Status de la connexion. Cet élément n’est pas utilisé par la fonction NetUseAdd . Les valeurs suivantes sont définies.

Valeur Signification
USE_OK
 La connexion réussit.
USE_PAUSED
 Suspendu par une station de travail locale.
USE_SESSLOST
 Déconnecté.
USE_DISCONN
 Une erreur est survenue.
USE_NETERR
 Une erreur réseau s’est produite.
USE_CONN
 La connexion est établie.
USE_RECONN
 Rebrancher.

ui2_asg_type

Type : DWORD

Type de ressource distante accessible. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
USE_WILDCARD
 Correspond au type des ressources partagées du serveur. Les caractères génériques ne peuvent être utilisés qu’avec la fonction NetUseAdd , et uniquement lorsque le membre ui2_local est une chaîne NULL . Pour plus d'informations, consultez la section Notes qui suit.
USE_DISKDEV
 Périphérique disque.
USE_SPOOLDEV
 Imprimante en pool.
USE_IPC
 Communication interprocess (IPC).

ui2_refcount

Type : DWORD

Nombre de fichiers, répertoires et autres processus ouverts sur la ressource distante. Cet élément n’est pas utilisé par la fonction NetUseAdd .

ui2_usecount

Type : DWORD

Nombre de connexions explicites (redirection avec un nom d’appareil local) ou de connexions UNC implicites (redirection sans nom d’appareil local) qui sont établies avec la ressource.

ui2_username

Type : LPWSTR

Pointeur vers une chaîne qui contient le nom de l’utilisateur qui a lancé la connexion.

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

ui2_domainname

Type : LMSTR

Pointeur vers une chaîne qui contient le nom de domaine de la ressource distante.

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

Remarques

La spécification d’un membre ui2_localnull demande l’authentification auprès du serveur sans rediriger une lettre de lecteur ou un appareil. Les redirections ultérieures impliquant le serveur alors que la même connexion est en vigueur utilisent les informations d’authentification spécifiées dans l’appel initial à la fonction NetUseAdd . Ces informations incluent la combinaison des membres ui2_password, ui2_username et ui2_domainname .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête lmuse.h (inclure Lm.h)

Voir aussi

NetUseAdd

NetUseEnum

NetUseGetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Utiliser des fonctions