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 |
|
| Archivo DLL |
|