Netzwerkfreigabefunktionen

Die Netzwerkfreigabefunktionen steuern freigegebene Ressourcen. Eine freigegebene Ressource ist eine lokale Ressource auf einem Server (z. B. ein Datenträgerverzeichnis, ein Druckgerät oder eine Named Pipe), auf die Benutzer und Anwendungen im Netzwerk zugreifen können.

Die Freigabefunktionen sind im Folgenden aufgeführt.

Funktion	BESCHREIBUNG
NetShareAdd	Gibt eine Ressource auf einem Server gemeinsam.
NetShareCheck	Fragt ab, ob ein Server ein Gerät gemeinsam verwendet.
NetShareDel	Löscht einen Freigabenamen aus der Liste der freigegebenen Ressourcen eines Servers.
NetShareEnum	Ruft Freigabeinformationen zu jeder freigegebenen Ressource auf einem Server ab.
NetShareGetInfo	Ruft Informationen zu einer angegebenen freigegebenen Ressource auf einem Server ab.
NetShareSetInfo	Legt die Parameter einer freigegebenen Ressource fest.

 

Die NetShareAdd-Funktion ermöglicht es einem Benutzer oder einer Anwendung, eine Ressource eines bestimmten Typs unter Verwendung des angegebenen Freigabenamens freizugeben. Die NetShareAdd-Funktion erfordert den Freigabenamen und den namen des lokalen Geräts, um die Ressource freizugeben. Ein Benutzer oder eine Anwendung muss über ein Konto auf dem Server verfügen, um auf die Ressource zugreifen zu können.

Sie können auch einen Sicherheitsdeskriptor angeben, der einer Freigabe zugeordnet werden soll. Sicherheitsbeschreibungen geben an, welche Benutzer über die Freigabe auf Dateien zugreifen dürfen und mit welchem Zugriffstyp. Geben Sie einen SECURITY_DESCRIPTOR mit der SHARE_INFO_502 Informationsebene an, wenn Sie NetShareAdd oder NetShareSetInfo aufrufen. NetShareSetInfo unterstützt die SHARE_INFO_1501 Informationsebene. Weitere Informationen zu Sicherheitsbeschreibungen finden Sie unter Access Control.

Die Netzwerkverwaltungsfunktionen verwenden die folgenden speziellen Freigabenamen für die Interprocess Communication (IPC) und die Remoteverwaltung des Servers:

• IPC$, reserviert für die prozessübergreifende Kommunikation
• ADMIN$, reserviert für die Remoteverwaltung
• A$, B$, C$ (und andere lokale Datenträgernamen gefolgt von einem Dollarzeichen), die lokalen Datenträgergeräten zugewiesen sind

Rufen Sie die NetConnectionEnum-Funktion auf, um alle Verbindungen aufzulisten, die mit einer freigegebenen Ressource auf einem Server hergestellt wurden, oder um alle Von einem bestimmten Computer hergestellten Verbindungen aufzulisten. Sie können NetConnectionEnum auf den CONNECTION_INFO_0 - und CONNECTION_INFO_1 Informationsebenen aufrufen.

Freigabefunktionen sind auf den folgenden Informationsebenen verfügbar:

SHARE_INFO_0
SHARE_INFO_1
SHARE_INFO_2
SHARE_INFO_501
SHARE_INFO_502
SHARE_INFO_1005

Die folgenden Informationsebenen sind nur für NetShareSetInfo gültig:

SHARE_INFO_1004
SHARE_INFO_1006
SHARE_INFO_1501

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 der Netzwerkverwaltungsfreigabefunktionen erreichen können. Weitere Informationen finden Sie unter IADsFileShare.