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.

Mit der NetShareAdd-Funktion kann ein Benutzer oder eine Anwendung eine Ressource eines bestimmten Typs unter Verwendung des angegebenen Freigabenamens freigeben. 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 welche Art von Zugriff sie haben. Geben Sie beim Aufrufen von NetShareAdd oder NetShareSetInfoeinen SECURITY _ DESCRIPTOR mit der Informationsebene SHARE INFO _ _ 502 an. NetShareSetInfo unterstützt die Informationsebene SHARE _ INFO _ 1501. Weitere Informationen zu Sicherheitsbeschreibungen finden Sie unter Access Control.

Die Netzwerkverwaltungsfunktionen verwenden die folgenden speziellen Freigabenamen für die prozessübergreifende Kommunikation (InterProcess Communication, IPC) und die Remoteverwaltung des Servers:

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

Um alle Verbindungen aufzulisten, die mit einer freigegebenen Ressource auf einem Server hergestellt wurden, oder um alle Verbindungen aufzulisten, die von einem bestimmten Computer hergestellt wurden, rufen Sie die NetConnectionEnum-Funktion auf. Sie können NetConnectionEnum auf den Informationsebenen CONNECTION INFO _ _ 0 und CONNECTION INFO _ _ 1 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 NetShareSetInfogü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 Funktionen der Netzwerkverwaltungsfreigabe erreichen können. Weitere Informationen finden Sie unter IADsFileShare.