Metodo Create della classe Win32_Share

Articolo
11/30/2023

Il metodo Creaclasse WMI avvia la condivisione per una risorsa server.

In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.

Sintassi

uint32 Create(
  [in]           string                   Path,
  [in]           string                   Name,
  [in]           uint32                   Type,
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] string                   Password,
  [in, optional] Win32_SecurityDescriptor Access
);

Parametri

Percorso [in]

Percorso locale della condivisione di Windows.

Ad esempio, "C:\Programmi".

Nome [in]

Passa l'alias a un percorso configurato come condivisione in un computer che esegue Windows.

Ad esempio, "public".

Tipo [in]

Passa il tipo di risorsa condivisa. I tipi includono unità disco, code di stampa, comunicazioni interprocessi (IPC) e dispositivi generali. Può essere uno dei valori seguenti.

Unità disco (0)

Coda di stampa (1)

Dispositivo (2)

IPC (3)

Amministrazione unità disco (2147483648)

Amministrazione coda di stampa (2147483649)

Amministrazione del dispositivo (2147483650)

IPC Amministrazione (2147483651)

MaximumAllowed [in, facoltativo]

Limite al numero massimo di utenti autorizzati a usare contemporaneamente questa risorsa.

Esempio: 10. Il parametro è facoltativo.

Descrizione [in, facoltativo]

Commento facoltativo per descrivere la risorsa condivisa. Il parametro è facoltativo.

Password [in, facoltativo]

Password (quando il server è in esecuzione con sicurezza a livello di condivisione) per la risorsa condivisa. Se il server è in esecuzione con sicurezza a livello di utente, questo parametro viene ignorato. Il parametro è facoltativo.

Accesso [in, facoltativo]

Descrittore di sicurezza per le autorizzazioni a livello di utente. Un descrittore di sicurezza contiene informazioni sulle autorizzazioni, il proprietario e le funzionalità di accesso della risorsa. Se questo parametro non viene fornito o è NULL, tutti hanno accesso in lettura alla condivisione. Per altre informazioni, vedere Win32_SecurityDescriptor e Modifica della sicurezza degli accessi in oggetti a protezione diretta.

Valore restituito

Restituisce uno dei valori elencati nell'elenco seguente o qualsiasi altro valore per indicare un errore. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Operazione riuscita (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 netto non trovato (25)
Altro (26 4294967295)

Osservazioni:

Create è un metodo statico.

Solo i membri del gruppo locale Amministrazione istrators o Account Operators o quelli con appartenenza al gruppo di operatori Communication, Print o Server possono eseguire correttamente Create. L'operatore Print può aggiungere solo code di stampanti. L'operatore Communication può aggiungere solo code di dispositivi di comunicazione.

Esempi

Il codice di PowerShell seguente crea una condivisione.

# create pointer to class
$comp=[WMICLASS]"Win32_share"

# create a new share
$comp.create("c:\","mynewshare",0)

# see results
gwmi win32_share

L'esempio di codice precedente restituisce quanto segue:

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     : 
__DYNASTY        : __PARAMETERS
__RELPATH        : 
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         : 
__NAMESPACE      : 
__PATH           : 
ReturnValue      : 2
PSComputerName   : 

Name        : ADMIN$
Path        : C:\Windows
Description : Remote Admin

Name        : C$
Path        : C:\
Description : Default share

Name        : CCMLOGS$
Path        : C:\Windows\CCM\Logs
Description : Public Share

Name        : ccmsetup$
Path        : C:\Windows\ccmsetup
Description : Public Share

Name        : Drop
Path        : C:\Drop
Description : 

Name        : IPC$
Path        : 
Description : Remote IPC

Name        : Share
Path        : C:\Share
Description :

L'esempio di codice C# seguente descrive come chiamare il metodo create.

private static void makeShare(string servername, string filepath, string sharename)
{
try
 {
 // assemble the string so the scope represents the remote server
 string scope = string.Format("\\\\{0}\\root\\cimv2", servername);

 // connect to WMI on the remote server
 ManagementScope ms = new ManagementScope(scope);

 // create a new instance of the Win32_Share WMI object
 ManagementClass cls = new ManagementClass("Win32_Share");

 // set the scope of the new instance to that created above
 cls.Scope = ms;

 // assemble the arguments to be passed to the Create method
 object[] methodargs = { filepath, sharename, "0" };

 // invoke the Create method to create the share
 object result = cls.InvokeMethod("Create", methodargs);
 }
catch (SystemException e)
 {
  Console.WriteLine("Error attempting to create share {0}:", sharename);
  Console.WriteLine(e.Message);
 }

}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo
Win32_Share

Condividi tramite