struttura USE_INFO_2 (lmuse.h)

  • Articolo

La struttura USE_INFO_2 contiene informazioni su una connessione tra un computer locale e una risorsa condivisa, inclusi il tipo di connessione, lo stato della connessione, il nome utente e il nome di dominio.

Sintassi

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;

Members

ui2_local

Tipo: LMSTR

Puntatore a una stringa contenente il nome del dispositivo locale (ad esempio, unità E o LPT1) reindirizzato alla risorsa condivisa. La costante DEVLEN specifica il numero massimo di caratteri nella stringa. Questo membro può essere NULL. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui2_remote

Tipo: LMSTR

Puntatore a una stringa contenente il nome della condivisione della risorsa remota. La stringa è nel formato

\\servername\sharename

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui2_password

Tipo: LMSTR

Puntatore a una stringa contenente la password necessaria per stabilire una sessione con una workstation specifica.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui2_status

Tipo: DWORD

Stato della connessione. Questo elemento non viene usato dalla funzione NetUseAdd . Vengono definiti i valori seguenti.

Valore Significato
USE_OK
 La connessione ha esito positivo.
USE_PAUSED
 Sospeso da una workstation locale.
USE_SESSLOST
 Disconnesso
USE_DISCONN
 Si è verificato un errore.
USE_NETERR
 Si è verificato un errore di rete.
USE_CONN
 La connessione viene stabilita.
USE_RECONN
 Riconnessione.

ui2_asg_type

Tipo: DWORD

Tipo di risorsa remota a cui si accede. Questo membro può essere uno dei valori seguenti.

Valore Significato
USE_WILDCARD
 Corrisponde al tipo di risorse condivise del server. I caratteri jolly possono essere usati solo con la funzione NetUseAdd e solo quando il membro ui2_local è una stringa NULL . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
USE_DISKDEV
 Dispositivo disco.
USE_SPOOLDEV
 Stampante con spooling.
USE_IPC
 Comunicazione interprocesso (IPC).

ui2_refcount

Tipo: DWORD

Numero di file, directory e altri processi aperti nella risorsa remota. Questo elemento non viene usato dalla funzione NetUseAdd .

ui2_usecount

Tipo: DWORD

Numero di connessioni esplicite (reindirizzamento con un nome di dispositivo locale) o connessioni UNC implicite (reindirizzamento senza un nome di dispositivo locale) stabilite con la risorsa.

ui2_username

Tipo: LPWSTR

Puntatore a una stringa contenente il nome dell'utente che ha avviato la connessione.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui2_domainname

Tipo: LMSTR

Puntatore a una stringa contenente il nome di dominio della risorsa remota.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

Commenti

Specifica di un membro ui2_local che è NULL richiede l'autenticazione con il server senza reindirizzare una lettera di unità o un dispositivo. I reindirizzamenti futuri che coinvolgono il server mentre la stessa connessione è attiva usano le informazioni di autenticazione specificate nella chiamata iniziale alla funzione NetUseAdd . Queste informazioni includono la combinazione dei membri ui2_password, ui2_username e ui2_domainname .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione lmuse.h (include Lm.h)

Vedi anche

NetUseAdd

NetUseEnum

NetUseGetInfo

Panoramica della gestione della rete

Strutture di gestione di rete

Usare funzioni