SetShareInfo-Methode der Win32_Share-Klasse
Die SetShareInfoWMI-Klassenmethode legt die Parameter einer freigegebenen Ressource fest.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetShareInfo(
[in, optional] uint32 MaximumAllowed,
[in, optional] string Description,
[in, optional] Win32_SecurityDescriptor Access
);
Parameter
-
MaximumAllowed [in, optional]
-
Limit für die maximale Anzahl von Benutzern, die diese Ressource gleichzeitig verwenden dürfen.
Beispiel: 10. Dieser Parameter ist optional.
-
Beschreibung [in, optional]
-
Optionaler Kommentar zur Beschreibung der freigegebenen Ressource.
-
Zugriff [in, optional]
-
Sicherheitsbeschreibung für Berechtigungen auf Benutzerebene. Ein Sicherheitsdeskriptor enthält Informationen zu den Berechtigungs-, Besitzer- und Zugriffsfunktionen der Ressource. Weitere Informationen finden Sie unter Win32_SecurityDescriptor.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, der auf einen Fehler hinweist.
-
Erfolg (0)
-
Zugriff verweigert (2)
-
Unbekannter Fehler (8)
-
Ungültiger Name (9)
-
Ungültige Ebene (10)
-
Ungültiger Parameter (21)
-
Doppelte Freigabe (22)
-
Umgeleiteter Pfad (23)
-
Unbekanntes Gerät oder Verzeichnis (24)
-
Netzname nicht gefunden (25)
-
Sonstige (26 4294967295)
Bemerkungen
Die SetShareInfo-Methode ist eine dynamische Objektmethode und wird für ein Vorkommen dieser Klasse verwendet.
Nur Mitglieder der lokalen Gruppe "Administratoren" oder "Kontooperatoren" oder "Benutzer mit Kommunikations-, Druck- oder Serveroperator"-Gruppen können SetShareInfo erfolgreich ausführen. Der Druckeroperator kann nur Druckerwarteschlangen festlegen. Der Kommunikationsoperator kann nur Kommunikationsgerätewarteschlangen festlegen.
Beispiele
Im folgenden PowerShell-Beispiel wird der Name der newShare-Freigabe aktualisiert.
$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|