Método SetShareInfo de la clase Win32_Share

El método de clase WMISetShareInfo establece los parámetros de un recurso compartido.

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 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

Parámetros

MaximumAllowed [in, optional]

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

Ejemplo: 10. Este parámetro es opcional.

Descripción [in, opcional]

Comentario opcional para describir el recurso que se va a compartir.

Acceso [in, opcional]

Descriptor de seguridad para permisos de nivel de usuario. Un descriptor de seguridad contiene información sobre las funcionalidades de permiso, propietario y acceso del recurso. Para obtener más información, vea Win32_SecurityDescriptor.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o cualquier otro valor para indicar un error.

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

El método SetShareInfo es un método de objeto dinámico y se usa en una aparición de esta clase.

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 SetShareInfo. El operador print solo puede establecer colas de impresora. El operador communication solo puede establecer colas de dispositivos de comunicación.

Ejemplos

En el ejemplo de PowerShell siguiente se actualiza el nombre del nuevo recurso compartido compartido .

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

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