Classe Win32_Share

Artigo
06/12/2023

A classe Win32_Share representa um recurso compartilhado em um sistema de computador que executa o Windows. Pode ser uma unidade de disco, impressora, comunicação entre processos ou outro dispositivo compartilhável. Para obter mais informações sobre como recuperar classes WMI, consulte Recuperando uma classe.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

Membros

A classe Win32_Share tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Win32_Share tem esses métodos.

Método	Descrição
Criar	Método de classe que inicia o compartilhamento para um recurso de servidor.
Excluir	Método de classe que exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor, desconectando conexões com o recurso compartilhado.
GetAccessMask	Retorna os direitos de acesso ao compartilhamento mantido pelo usuário ou grupo em cujo nome a instância é retornada. Você deve usar esse método no lugar da propriedade AccessMask , que é sempre NULL.
SetShareInfo	Método de classe que define os parâmetros de um recurso compartilhado.

Propriedades

A classe Win32_Share tem essas propriedades.

AccessMask

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: PRETERIDO

Essa propriedade está obsoleta e não é mais usada. Em vez disso, use o método Win32_Share.GetAccessMask . O valor da propriedade AccessMask é definido como nulo pelo WMI. Para obter mais informações sobre como definir o acesso quando um compartilhamento é criado, consulte o método Create .

AllowMaximum

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_max_uses")

O número de usuários simultâneos para esse recurso foi limitado. Se True, o valor na propriedade MaximumAllowed será ignorado.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

MaximumAllowed

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_max_uses")

Limite o número máximo de usuários autorizados a usar esse recurso simultaneamente. O valor só será válido se a propriedade AllowMaximum estiver definida como FALSE.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: key, Override ("Name"), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_1|shi1_netname")

Alias fornecido a um caminho configurado como um compartilhamento em um sistema de computador que executa o Windows.

Exemplo do Windows 2008: "\SERVER01\public" – o Windows Server 2008 exige que você coloque o UNC no nome.

Caminho

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_path")

Caminho local do compartilhamento do Windows.

Exemplo: "C:\Program Files"

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. As status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

Tipo

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_type")

Tipo de recurso que está sendo compartilhado. Os tipos incluem: unidades de disco, filas de impressão, IPC (comunicação entre processos) e dispositivos gerais.

Unidade de disco (0)

Fila de Impressão (1)

Dispositivo (2)

IPC (3)

Administração de unidade de disco (2147483648)

Administração de Fila de Impressão (2147483649)

Administração de dispositivo (2147483650)

IPC Administração (2147483651)

Comentários

A classe Win32_Share é derivada de CIM_LogicalElement.

O método Create nessa classe é um método estático. Os métodos Delete, GetAccessMask e SetShareInfo são todos métodos de instância.

Dependendo de suas permissões de segurança, talvez você não consiga recuperar todas as propriedades dessa classe. Por exemplo, as propriedades AllowMaximum, MaximumAllowed, Path e Type podem retornar nulo. De um modo geral, os Usuários avançados e administradores poderão recuperar todos os valores de propriedade.

Exemplos

Oexemplo de código da Central de Scripts a seguir lista todos os compartilhamentos em um computador e lista todas as permissões de compartilhamento para cada compartilhamento.

As consultas de exemplo Obter Informações de Compartilhamento semelhantes a Win32_Share PowerShell Win32_Share e fornece os resultados.

O exemplo do PowerShell a seguir exibe os compartilhamentos no sistema local.

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

Como alternativa, se você quiser filtrar com mais precisão, poderá usar o seguinte snippet do PowerShell:

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

O exemplo VBScript a seguir exibe os compartilhamentos no sistema local.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

CIM_LogicalElement
Classes do sistema operacional
Tarefas do WMI: arquivos e pastas

Compartilhar via

Classe Win32_Share

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais