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:
Die folgenden Informationsebenen sind nur für NetShareSetInfo gültig:
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.