NetFileClose-Funktion (lmshare.h)

  • Artikel

Erzwingt das Schließen einer Ressource. Diese Funktion kann verwendet werden, wenn ein Fehler das Schließen auf andere Weise verhindert. Sie sollten NetFileClose mit Vorsicht verwenden, da die auf dem Clientsystem zwischengespeicherten Daten vor dem Schließen der Datei nicht in die Datei geschrieben werden.

Syntax

NET_API_STATUS NET_API_FUNCTION NetFileClose(
  [in] LMSTR servername,
  [in] DWORD fileid
);

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, instance geschlossen werden soll.

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.

Hinweise

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

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

Weitere Informationen

NetFile-Funktionen

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung