NetShareDelEx-Funktion (lmshare.h)

Artikel
03/01/2024

Löscht einen Freigabenamen aus der Liste der freigegebenen Ressourcen eines Servers, wodurch alle Verbindungen mit dieser Freigabe getrennt werden. Mit dieser Funktion, die eine erweiterte Version der NetShareDel-Funktion darstellt, kann der Aufrufer eine SHARE_INFO_0-, SHARE_INFO_1-, SHARE_INFO_2-, SHARE_INFO_502- oder SHARE_INFO_503-Struktur angeben.

Syntax

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

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] level

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

Wert	Bedeutung
0, 1, 2 oder 502	Gibt Informationen zur freigegebenen Ressource an, einschließlich des Namens der Ressource, des Typs und der Berechtigungen sowie der Anzahl der Verbindungen. Der buf-Parameter verweist auf eine SHARE_INFO_0-, SHARE_INFO_1-, SHARE_INFO_2- oder SHARE_INFO_502-Struktur .
503	Gibt Informationen zur freigegebenen Ressource an, einschließlich des Namens der Ressource, des Typs und der Berechtigungen, der Anzahl der Verbindungen und anderer relevanter Informationen. Der buf-Parameter verweist auf eine SHARE_INFO_503-Struktur .

[in] buf

Zeiger auf den Puffer, der die Daten angibt. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

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_INTERNAL_ERROR	Interner Fehler.
ERROR_INVALID_LEVEL	Der für den Levelparameter angegebene Wert ist ungültig.
ERROR_NOT_SUPPORTED	Die Anforderung wird nicht unterstützt.

Hinweise

Wenn 503 für den Levelparameter angegeben wird, verweist der buf-Parameter auf eine SHARE_INFO_503-Struktur , und die shi503_netname und shi503_servername Member dieser Struktur werden verwendet, um die freigegebene Ressource auf dem Server zu suchen. die anderen Member werden ignoriert. Der im shi503_servername-Member angegebene Remoteserver muss mithilfe der NetServerTransportAddEx-Funktion an ein Transportprotokoll gebunden worden sein. Beim Aufruf von NetServerTransportAddEx muss entweder 2 oder 3 für den Levelparameter angegeben worden sein, und das SVTI2_SCOPED_NAME-Flag muss in der SERVER_TRANSPORT_INFO_2-Struktur für das Transportprotokoll angegeben worden sein.

Wenn für den Levelparameter 0, 1, 2 oder 502 angegeben wird, verweist der buf-Parameter auf eine SHARE_INFO_0-, SHARE_INFO_1-, SHARE_INFO_2- oder SHARE_INFO_502-Struktur , und das shi0_netname, shi1_netname, shi2_netname oder shi502_netname Element dieser Struktur wird verwendet. die anderen Member werden ignoriert.

Anforderungen

Anforderung	Wert
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