Crear método de la clase Win32_Share

El método de clase CreateWMI inicia el uso compartido de un recurso de servidor.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

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
);

Parámetros

Ruta de acceso [in]

Ruta de acceso local del recurso compartido de Windows.

Por ejemplo, "C:\Archivos de programa".

Nombre [in]

Pasa el alias a una ruta de acceso configurada como recurso compartido en un sistema informático que ejecuta Windows.

Por ejemplo, "public".

Tipo [in]

Pasa el tipo de recurso que se comparte. Los tipos incluyen unidades de disco, colas de impresión, comunicaciones entre procesos (IPC) y dispositivos generales. Puede ser uno de los valores siguientes.

Unidad de disco (0)

Cola de impresión (1)

Dispositivo (2)

IPC (3)

Administración de unidad de disco (2147483648)

Administración de cola de impresión (2147483649)

Administración de dispositivo (2147483650)

Administración IPC (2147483651)

MaximumAllowed [in, optional]

Límite en el número máximo de usuarios que pueden usar simultáneamente este recurso.

Ejemplo: 10. Este parámetro es opcional.

Descripción [in, opcional]

Comentario opcional para describir el recurso que se va a compartir. Este parámetro es opcional.

Contraseña [in, opcional]

Contraseña (cuando el servidor se ejecuta con seguridad de nivel de recurso compartido) para el recurso compartido. Si el servidor se ejecuta con seguridad de nivel de usuario, se omite este parámetro. Este parámetro es opcional.

Acceso [in, opcional]

Descriptor de seguridad para permisos de nivel de usuario. Un descriptor de seguridad contiene información sobre los permisos, el propietario y las funcionalidades de acceso del recurso. Si este parámetro no se proporciona o es NULL, Todos tienen acceso de lectura al recurso compartido. Para obtener más información, vea Win32_SecurityDescriptor y Cambio de seguridad de acceso en objetos protegibles.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o cualquier otro valor para indicar un error. Para obtener códigos de error adicionales, consulte Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Correcto (0)

Acceso denegado (2)

Error desconocido (8)

Nombre no válido (9)

Nivel no válido (10)

Parámetro no válido (21)

Recurso compartido duplicado (22)

Ruta de acceso redirigida (23)

Dispositivo o directorio desconocido (24)

No se encontró el nombre neto (25)

Otros (26 4294967295)

Comentarios

Create es un método estático.

Solo los miembros del grupo local Administradores o Operadores de cuenta o los que tienen pertenencia a grupos de operadores de comunicación, impresión o servidor pueden ejecutar correctamente Create. El operador Print solo puede agregar colas de impresora. El operador Communication solo puede agregar colas de dispositivos de comunicación.

Ejemplos

El ejemplo exportar e importar recursos compartidos de archivos de PowerShell exporta e importa recursos compartidos de archivos y establece permisos de recurso compartido. Del mismo modo, el ejemplo Crear un recurso compartido y establecer permisos también crea un recurso compartido y establece los permisos de recurso compartido.

El siguiente código de PowerShell crea un recurso compartido.

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

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

# see results
gwmi win32_share 

El ejemplo de código anterior devuelve lo siguiente:

__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 : 

En el ejemplo de código de C# siguiente se describe cómo llamar al método 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);
 }

}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo

Win32_Share