NetUseGetInfo-Funktion (lmuse.h)

Artikel
08/24/2023

Die NetUseGetInfo-Funktion ruft Informationen zu einer Verbindung mit einer freigegebenen Ressource ab.

Sie können auch die WNetGetConnection-Funktion verwenden, um den Namen einer Netzwerkressource abzurufen, die einem lokalen Gerät zugeordnet ist.

Syntax

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Parameter

[in] UncServerName

Der UNC-Name des Computers, auf dem diese Funktion ausgeführt werden soll. Wenn der Parameter NULL ist, wird der lokale Computer verwendet. Wenn der angegebene UncServerName-Parameter ein Remotecomputer ist, muss der Remotecomputer RPC-Remoteaufrufe mithilfe des älteren Remotezugriffsprotokollmechanismus unterstützen.

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

[in] UseName

Ein Zeiger auf eine Zeichenfolge, die den Namen der Verbindung angibt, für die Informationen zurückgegeben werden sollen.

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

[in] LevelFlags

Die Informationsebene der angeforderten Daten. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Gibt einen lokalen Gerätenamen und den Freigabenamen einer Remoteressource an. Der BufPtr-Parameter ist ein Zeiger auf eine USE_INFO_0-Struktur .
1	Gibt Informationen zur Verbindung zwischen einem lokalen Gerät und einer freigegebenen Ressource an, einschließlich verbindungs status und Typs. Der BufPtr-Parameter ist ein Zeiger auf eine USE_INFO_1 Struktur.
2	Gibt Informationen zur Verbindung zwischen einem lokalen Gerät und einer freigegebenen Ressource an. Zu den Informationen gehören die verbindungs-status, der Verbindungstyp, der Benutzername und der Domänenname. Der BufPtr-Parameter ist ein Zeiger auf eine USE_INFO_2-Struktur .

[out] bufptr

Ein Zeiger auf den Puffer, der die Daten empfängt. Das Format dieser Daten hängt vom Wert des Parameters Level ab. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Zum Aufrufen der NetUseGetInfo-Funktion ist keine spezielle Gruppenmitgliedschaft erforderlich. Diese Funktion kann nicht auf einem Remoteserver ausgeführt werden, außer in Fällen der Abwärtskompatibilität.

Um alle aktuellen Verbindungen zwischen dem lokalen Computer und Ressourcen auf Remoteservern aufzulisten, können Sie die NetUseEnum-Funktion aufrufen.

Diese Funktion gilt nur für den Client server Message Block (LAN Manager Workstation). Die NetUseGetInfo-Funktion unterstützt keine DFS-Freigaben (Distributed File System). Verwenden Sie die WNetGetConnection-Funktion , um Informationen für eine Freigabe mit einem anderen Netzwerkanbieter (z. B. WebDAV oder DFS-Freigabe) abzurufen.

Anforderungen


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