Freigabefunktionen

Die Funktionen der Netzwerkverwaltungsfreigabe 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 wieder.
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.

Diese Freigabefunktion gilt nur für Freigaben auf einem Server Message Block (LAN Manager)-Server. Diese Freigabefunktionen unterstützen keine verteiltes Dateisystem (DFS) Freigaben. Beispielsweise kann die NetShareGetInfo-Funktion nur Informationen für eine angegebene Freigaberessource auf einem SMB-Server abrufen. Verwenden Sie die WNetGetConnection-Funktion, um Informationen für eine Freigabe mithilfe eines anderen Netzwerkanbieters (z. B. WebDAV oder DFS-Freigabe) abzurufen.

Die NetShareAdd-Funktion ermöglicht es einem Benutzer oder einer Anwendung, eine Ressource eines bestimmten Typs unter Verwendung des angegebenen Freigabenamens gemeinsam zu nutzen. Die NetShareAdd-Funktion erfordert den Freigabenamen und den Namen des lokalen Geräts, um die Ressource gemeinsam nutzen zu können. 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. Sicherheitsdeskriptoren geben an, welche Benutzer über die Freigabe auf Dateien zugreifen dürfen und mit welchem Zugriffstyp. 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 Sicherheitsdeskriptoren 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$, reserviert für 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, die mit einer freigegebenen Ressource auf einem Server hergestellt wurden, oder alle von einem bestimmten Computer hergestellten Verbindungen auflisten zu können. Sie können NetConnectionEnum auf den Informationsebenen CONNECTION INFO _ _ 0 und CONNECTION INFO _ _ 1 aufrufen.

Freigabefunktionen sind auf den folgenden Informationsebenen verfügbar, obwohl einige Freigabeebenen nur für einige der Freigabefunktionen gelten:

Weitere Informationen finden Sie in der Dokumentation zu einer bestimmten Freigabefunktion.

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.