USE_INFO_2-Struktur (lmuse.h)
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.
ui2_asg_type
Art: DWORD
Der Typ der Remoteressource, auf die zugegriffen wird. Dieser Member kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
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". |
|
Datenträgergerät. |
|
Spooldrucker. |
|
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) |