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	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen

Win32_Share