Metodo SetShareInfo della classe Win32_Share
Il metodo di classe WMISetShareInfo imposta i parametri di una risorsa condivisa.
Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 SetShareInfo(
[in, optional] uint32 MaximumAllowed,
[in, optional] string Description,
[in, optional] Win32_SecurityDescriptor Access
);
Parametri
-
MaximumAllowed [in, facoltativo]
-
Limite al numero massimo di utenti autorizzati a usare questa risorsa simultaneamente.
Esempio: 10. Questo parametro è facoltativo e,
-
Descrizione [in, facoltativo]
-
Commento facoltativo per descrivere la risorsa condivisa.
-
Accesso [in, facoltativo]
-
Descrittore di sicurezza per le autorizzazioni a livello di utente. Un descrittore di sicurezza contiene informazioni sulle funzionalità di autorizzazione, proprietario e accesso della risorsa. Per altre informazioni, vedere Win32_SecurityDescriptor.
Valore restituito
Restituisce uno dei valori elencati nell'elenco seguente o qualsiasi altro valore per indicare un errore.
-
Successo (0)
-
Accesso negato (2)
-
Errore sconosciuto (8)
-
Nome non valido (9)
-
Livello non valido (10)
-
Parametro non valido (21)
-
Condivisione duplicata (22)
-
Percorso reindirizzato (23)
-
Dispositivo o directory sconosciuto (24)
-
Nome net non trovato (25)
-
Altro (26 4294967295)
Commenti
Il metodo SetShareInfo è un metodo oggetto dinamico e viene usato in un'occorrenza di questa classe.
Solo i membri del gruppo locale Amministratori o Operatori account o quelli con appartenenza al gruppo di operatori di comunicazione, stampa o server possono eseguire correttamente SetShareInfo. L'operatore di stampa può impostare solo le code della stampante. L'operatore di comunicazione può impostare solo le code dei dispositivi di comunicazione.
Esempio
L'esempio di PowerShell seguente aggiorna il nome della nuova condivisioneShare .
$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Radice\CIMV2 |
| MOF |
|
| DLL |
|