USE_INFO_2-Struktur (lmuse.h)

Artikel
02/28/2024

Die USE_INFO_2-Struktur enthält Informationen zu einer Verbindung zwischen einem lokalen Computer und einer freigegebenen Ressource, einschließlich Verbindungstyp, verbindungs status, Benutzername und Domänenname.

Syntax

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;

Member

ui2_local

Typ: LMSTR

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

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

ui2_remote

Typ: LMSTR

Ein Zeiger auf eine Zeichenfolge, die den Freigabenamen der Remoteressource enthält. Die Zeichenfolge befindet sich im Format

\\servername\sharename

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

ui2_password

Typ: LMSTR

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

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

ui2_status

Art: DWORD

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

Wert	Bedeutung
USE_OK	Die Verbindung ist erfolgreich.
USE_PAUSED	Wird von einer 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.

ui2_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. Wildcards können nur mit der NetUseAdd-Funktion und nur verwendet werden, wenn der ui2_local Member eine NULL-Zeichenfolge ist. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
USE_DISKDEV	Datenträgergerät.
USE_SPOOLDEV	Spooldrucker.
USE_IPC	Interprocess Communication (IPC).

ui2_refcount

Art: DWORD

Die Anzahl der Dateien, Verzeichnisse und anderen Prozesse, die in der Remoteressource geöffnet sind. Dieses Element wird von der NetUseAdd-Funktion nicht verwendet.

ui2_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 hergestellt werden.

ui2_username

Typ: LPWSTR

Ein Zeiger auf eine Zeichenfolge, die den Namen des Benutzers enthält, der die Verbindung initiiert hat.

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

ui2_domainname

Typ: LMSTR

Ein Zeiger auf eine Zeichenfolge, die den Domänennamen der Remoteressource enthält.

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

Hinweise

Die Angabe eines ui2_local Member, 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 aktiv ist, verwenden die Authentifizierungsinformationen, die im ersten Aufruf der NetUseAdd-Funktion angegeben sind. Diese Informationen umfassen die Kombination aus ui2_password, ui2_username und ui2_domainname Membern.

Anforderungen

Anforderung	Wert
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)