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

Vedi anche

Classi del sistema operativo

Win32_Share