NetFileGetInfo-Funktion (lmshare.h)

Artikel
08/24/2023

Ruft Informationen zu einem bestimmten Öffnen einer Serverressource ab.

Syntax

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

Parameter

[in] servername

Zeiger auf eine Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

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

[in] fileid

Gibt den Dateibezeichner der geöffneten Ressource an, für die Informationen zurückgegeben werden sollen. Der Wert dieses Parameters muss in einem vorherigen Enumerationsaufruf zurückgegeben worden sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
2	Geben Sie die Dateiidentifikationsnummer zurück. Der bufptr-Parameter ist ein Zeiger auf eine FILE_INFO_2-Struktur .
3	Geben Sie die Dateiidentifikationsnummer und andere Informationen zur Datei zurück. Der bufptr-Parameter ist ein Zeiger auf eine FILE_INFO_3-Struktur .

[out] bufptr

Zeiger auf die Adresse des Puffers, der die Informationen empfängt. Das Format dieser Daten hängt vom Wert des level-Parameters ab. Dieser Puffer wird vom System zugeordnet 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, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
ERROR_FILE_NOT_FOUND	Die Datei wurde nicht gefunden.
ERROR_INVALID_LEVEL	Der für den level-Parameter angegebene Wert ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher ist verfügbar.
NERR_BufTooSmall	Der bereitgestellte Puffer ist zu klein.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren oder Serveroperatoren können die NetFileGetInfo-Funktion erfolgreich ausführen.

Sie können die NetFileEnum-Funktion aufrufen, um Informationen zu mehreren Dateien abzurufen, die auf einem Server geöffnet sind.

Wenn Sie für Active Directory programmieren, können Sie möglicherweise bestimmte ADSI-Methoden (Active Directory Service Interface) aufrufen, um die gleiche Funktionalität zu erreichen, die Sie durch Aufrufen von NetFileGetInfo erreichen können. Weitere Informationen finden Sie unter IADsResource und IADsFileServiceOperations.

Anforderungen


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