Freigeben über


Netzwerkfreigabefunktionen

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

Die Freigabefunktionen sind im Folgenden aufgeführt.

Funktion Beschreibung
NetShareAdd- Teilt eine Ressource auf einem Server.
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 mithilfe des angegebenen Freigabenamens freigeben. Die NetShareAdd--Funktion erfordert den Freigabenamen und den lokalen Gerätenamen, um die Ressource zu teilen. Ein Benutzer oder eine Anwendung muss über ein Konto auf dem Server verfügen, um auf die Ressource zuzugreifen.

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 eine 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 Sicherheitsdeskriptoren finden Sie unter Zugriffssteuerung.

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

  • IPC$, reserviert für die Interprocess-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 zum Auflisten aller Verbindungen mit einer freigegebenen Ressource auf einem Server oder zum Auflisten aller Verbindungen, die von einem bestimmten Computer hergestellt wurden, die NetConnectionEnum--Funktion auf. Sie können NetConnectionEnum- auf der CONNECTION_INFO_0- und CONNECTION_INFO_1 Informationsebene 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 Informationsstufen sind nur für NetShareSetInfogültig:

SHARE_INFO_1004
SHARE_INFO_1006
SHARE_INFO_1501

Wenn Sie 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 erreichen können, indem Sie die Netzwerkverwaltungsfreigabefunktionen aufrufen. Weitere Informationen finden Sie unter IADsFileShare.