struttura USE_INFO_1 (lmuse.h)

  • Articolo

La struttura USE_INFO_1 contiene informazioni sulla connessione tra un dispositivo locale e una risorsa condivisa. Le informazioni includono lo stato della connessione e il tipo di connessione.

Sintassi

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

Members

ui1_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 .

ui1_remote

Tipo: LMSTR

Puntatore a una stringa contenente il nome della condivisione della risorsa remota a cui si accede. La stringa è nel formato seguente:

\\servername\sharename

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui1_password

Tipo: LMSTR

Puntatore a una stringa contenente la password necessaria per stabilire una sessione tra una workstation specifica e un server.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

ui1_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 è valida.
USE_PAUSED
 Sospeso dalla 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.

ui1_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 ui1_local è NULL. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
USE_DISKDEV
 Dispositivo disco.
USE_SPOOLDEV
 Stampante con spooling.
USE_IPC
 Comunicazione interprocesso (IPC).

ui1_refcount

Tipo: DWORD

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

ui1_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.

Commenti

Specificando un membro ui1_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 la password specificata dal membro ui1_password nella chiamata iniziale alla funzione NetUseAdd .

Requisiti

   
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