NetFileClose-Funktion (lmshare.h)
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 |
|---|---|
|
Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen. |
|
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 |