USE_INFO_1-Struktur (lmuse.h)
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.
ui1_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. 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". |
|
Datenträgergerät. |
|
Spooldrucker. |
|
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) |