structure USE_INFO_2 (lmuse.h)

Article
02/28/2024

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)