USE_INFO_1-Struktur (lmuse.h)

  • Artikel

Die USE_INFO_1-Struktur enthält Informationen zur Verbindung zwischen einem lokalen Gerät und einer freigegebenen Ressource. Die Informationen umfassen verbindungs status und Verbindungstyp.

Syntax

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

Typ: LMSTR

Ein Zeiger auf eine Zeichenfolge, die den lokalen Gerätenamen (z. B. Laufwerk E oder LPT1) enthält, der an die freigegebene Ressource umgeleitet wird. Die Konstante DEVLEN gibt die maximale Anzahl von Zeichen in der Zeichenfolge an. Dieses Element kann NULL sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.

ui1_remote

Typ: LMSTR

Ein Zeiger auf eine Zeichenfolge, die den Freigabenamen der Remoteressource enthält, auf die zugegriffen wird. Die Zeichenfolge hat folgendes Format:

\\servername\sharename

Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.

ui1_password

Typ: LMSTR

Ein Zeiger auf eine Zeichenfolge, die das Kennwort enthält, das zum Einrichten einer Sitzung zwischen einer bestimmten Arbeitsstation und einem Server erforderlich ist.

Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.

ui1_status

Art: DWORD

Der status der Verbindung. Dieses Element wird nicht von der NetUseAdd-Funktion verwendet. Die folgenden Werte werden definiert.

Wert Bedeutung
USE_OK
 Die Verbindung ist gültig.
USE_PAUSED
 Von der lokalen Arbeitsstation angehalten.
USE_SESSLOST
 Getrennt
USE_DISCONN
 Ein Fehler ist aufgetreten.
USE_NETERR
 Ein Netzwerkfehler ist aufgetreten.
USE_CONN
 Die Verbindung wird hergestellt.
USE_RECONN
 Wiederherstellen.

ui1_asg_type

Art: DWORD

Der Typ der Remoteressource, auf die zugegriffen wird. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
USE_WILDCARD
 Entspricht dem Typ der freigegebenen Ressourcen des Servers. Feldhalter können nur mit der NetUseAdd-Funktion und nur verwendet werden, wenn der ui1_local Member NULL ist. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
USE_DISKDEV
 Datenträgergerät.
USE_SPOOLDEV
 Spooldrucker.
USE_IPC
 Interprocess Communication (IPC).

ui1_refcount

Art: DWORD

Die Anzahl von Dateien, Verzeichnissen und anderen Prozessen, die auf der Remoteressource geöffnet sind. Dieses Element wird nicht von der NetUseAdd-Funktion verwendet.

ui1_usecount

Art: DWORD

Die Anzahl expliziter Verbindungen (Umleitung mit einem lokalen Gerätenamen) oder impliziter UNC-Verbindungen (Umleitung ohne lokalen Gerätenamen), die mit der Ressource eingerichtet werden.

Hinweise

Geben Sie einen ui1_local Member an, der NULL ist, fordert die Authentifizierung beim Server an, ohne einen Laufwerkbuchstaben oder ein Gerät umzuleiten. Zukünftige Umleitungen, die den Server betreffen, während dieselbe Verbindung wirksam ist, verwenden das Kennwort, das vom ui1_password-Member beim ersten Aufruf der NetUseAdd-Funktion angegeben wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile lmuse.h (lm.h einschließen)

Weitere Informationen

NetUseAdd

NetUseEnum

NetUseGetInfo

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

Verwenden von Funktionen