Classe Win32_Directory

Artigo
06/12/2023

A classe WMIWin32_Directory representa uma entrada de diretório em um sistema de computador que executa o Windows. Um diretório é um tipo de arquivo que agrupa logicamente arquivos de dados e fornece informações de caminho para os arquivos agrupados. Exemplo: C:\TEMP. Win32_Directory não inclui diretórios de unidades de rede.

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

Sintaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4C7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Directory : CIM_Directory
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   AccessMask;
  boolean  Archive;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Path;
  boolean  Readable;
  boolean  System;
  boolean  Writeable;
};

Membros

A classe Win32_Directory tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Win32_Directory tem esses métodos.

Método	Descrição
ChangeSecurityPermissions	Método de classe que altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto.
ChangeSecurityPermissionsEx	Método de classe que altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto.
Comprimir	Método de classe que compacta o arquivo lógico (ou diretório) especificado no caminho do objeto.
CompressEx	Método de classe que compacta o arquivo lógico (ou diretório) especificado no caminho do objeto.
Copiar	Método de classe que copia o arquivo lógico ou diretório especificado no caminho do objeto para o local especificado pelo parâmetro de entrada.
CopyEx	Método de classe que copia o arquivo lógico ou diretório especificado no caminho do objeto para o local especificado pelo parâmetro FileName .
Excluir	Método de classe que exclui o arquivo lógico (ou diretório) especificado no caminho do objeto.
DeleteEx	Método de classe que exclui o arquivo lógico (ou diretório) especificado no caminho do objeto.
GetEffectivePermission	Método de classe que determina se o chamador tem as permissões agregadas especificadas pelo argumento Permissions não apenas no objeto de arquivo, mas no compartilhamento em que o arquivo ou diretório reside (se estiver em um compartilhamento).
Renomear	Método de classe que renomeia o arquivo lógico (ou diretório) especificado no caminho do objeto.
Takeownership	Método de classe que obtém a propriedade do arquivo lógico especificado no caminho do objeto.
TakeOwnerShipEx	Método de classe que obtém a propriedade do arquivo lógico especificado no caminho do objeto.
Descompactar	Método de classe que descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto.
UncompressEx	Método de classe que descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto.

Propriedades

A classe Win32_Directory tem essas propriedades.

AccessMask

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Direitos de Acesso")

Bitmask que representa os direitos de acesso necessários para acessar ou executar operações específicas no diretório. Para valores de bit, consulte Constantes de direitos de acesso de arquivo e diretório.

Observação

Em volumes FAT, o valor FULL_ACCESS é retornado, o que indica que nenhuma segurança foi definida no objeto.

Essa propriedade é herdada de CIM_LogicalFile.

FILE_READ_DATA (arquivo) ou FILE_LIST_DIRECTORY (diretório) (1)

Concede o direito de ler dados do arquivo. Para um diretório, esse valor concede o direito de listar o conteúdo do diretório.

FILE_WRITE_DATA (arquivo) ou FILE_ADD_FILE (diretório) (2)

Concede o direito de gravar dados no arquivo. Para um diretório, esse valor concede o direito de criar um arquivo no diretório .

FILE_APPEND_DATA (arquivo) ou FILE_ADD_SUBDIRECTORY (4)

Concede o direito de acrescentar dados ao arquivo. Para um diretório, esse valor concede o direito de criar um subdiretório.

FILE_READ_EA (8)

Concede o direito de ler atributos estendidos.

FILE_WRITE_EA (16)

Concede o direito de gravar atributos estendidos.

FILE_EXECUTE (arquivo) ou FILE_TRAVERSE (diretório) (32)

Concede o direito de executar um arquivo. Para um diretório, o diretório pode ser percorrido.

FILE_DELETE_CHILD (diretório) (64)

Concede o direito de excluir um diretório e todos os arquivos que ele contém (seus filhos), mesmo que os arquivos sejam somente leitura.

FILE_READ_ATTRIBUTES (128)

Concede o direito de ler atributos de arquivo.

FILE_WRITE_ATTRIBUTES (256)

Concede o direito de alterar atributos de arquivo.

DELETE (65536)

Concede acesso de exclusão.

READ_CONTROL (131072)

Concede acesso de leitura ao descritor de segurança e ao proprietário.

WRITE_DAC (262144)

Concede acesso de gravação à ACL discricionária.

WRITE_OWNER (524288)

Atribui o proprietário da gravação.

SYNCHRONIZE (1048576)

Sincroniza o acesso e permite que um processo aguarde até que um objeto entre no estado sinalizado.

ACCESS_SYSTEM_SECURITY (18809343)

Controla a capacidade de obter ou definir a SACL no descritor de segurança de um objeto.

Arquivar

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Deve ser arquivado")

Indica se o bit de arquivo morto na pasta foi definido. O bit de arquivo morto é usado por programas de backup para identificar arquivos que devem ser copiados em backup. Se True, o arquivo deverá ser arquivado.

Essa propriedade é herdada de CIM_LogicalFile.

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.

Compactado

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Compactado")

Indica se a pasta foi compactada ou não. O WMI reconhece pastas compactadas usando o próprio WMI ou usando a interface gráfica do usuário; no entanto, ele não reconhece .ZIP arquivos como sendo compactados. Se True, o arquivo será compactado.

Essa propriedade é herdada de CIM_LogicalFile.

CompressionMethod

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Método compression")

Algoritmo ou ferramenta (geralmente um método) usado para compactar o arquivo lógico. Se não for possível (ou não desejado) descrever o esquema de compactação (talvez porque não seja conhecido), use as seguintes palavras: "Desconhecido" para representar que não se sabe se o arquivo lógico é compactado; "Compactado" para representar que o arquivo é compactado, mas seu esquema de compactação não é conhecido ou não é divulgado; e "Não Compactado" para representar que o arquivo lógico não é compactado.

Essa propriedade é herdada de CIM_LogicalFile.

CreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: CIM_Key, DisplayName ("Nome da Classe")

Nome da primeira classe concreta a aparecer na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades principais da classe, essa propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_LogicalFile.

CreationDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Data de Criação")

Data em que o objeto do sistema de arquivos foi criado. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.

Essa propriedade é herdada de CIM_LogicalFile.

CSCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nome da Classe do Sistema do Computador")

Nome da classe de criação do sistema de computador de escopo.

Essa propriedade é herdada de CIM_LogicalFile.

CSName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nome do Sistema do Computador")

Nome do computador em que o objeto do sistema de arquivos é armazenado.

Essa propriedade é herdada de CIM_LogicalFile.

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.

Dirigir

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Unidade")

Letra de unidade da unidade (incluindo dois-pontos) em que o objeto do sistema de arquivos é armazenado.

Exemplo: "c:"

Essa propriedade é herdada de CIM_LogicalFile.

EightDotThreeFileName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Eight Dot Three File Name")

MS-DOS -nome compatível com a pasta.

Exemplo: "c:\progra~1"

Essa propriedade é herdada de CIM_LogicalFile.

Criptografado

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Criptografado")

Indica se a pasta foi criptografada ou não. Se True, a pasta será criptografada.

Essa propriedade é herdada de CIM_LogicalFile.

Encryptionmethod

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Método encryption")

Algoritmo ou ferramenta usada para criptografar o arquivo lógico. Se não for possível (ou não desejado) descrever o esquema de criptografia (talvez por motivos de segurança), use as seguintes palavras: "Desconhecido" para representar que não se sabe se o arquivo lógico está criptografado; "Criptografado" para representar que o arquivo está criptografado, mas seu esquema de criptografia não é conhecido ou não é divulgado; e "Não Criptografado" para representar que o arquivo lógico não está criptografado.

Essa propriedade é herdada de CIM_LogicalFile.

Extensão

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Extensão de Arquivo")

Extensão de nome de arquivo para o objeto do sistema de arquivos, sem incluir o ponto (.) que separa a extensão do nome do arquivo.

Exemplos: "txt", "mof", "mdb"

Essa propriedade é herdada de CIM_LogicalFile.

FileName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Nome do Arquivo")

Nome do arquivo (sem o ponto ou extensão) do arquivo.

Exemplo: "autoexec"

Essa propriedade é herdada de CIM_LogicalFile.

FileSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Size"), Unidades ("bytes")

Tamanho do objeto do sistema de arquivos, em bytes. Embora as pastas possuam uma propriedade FileSize , o valor 0 sempre é retornado. Para determinar o tamanho de uma pasta, use o FileSystemObject ou adicione o tamanho de todos os arquivos armazenados na pasta.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Essa propriedade é herdada de CIM_LogicalFile.

FileType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Tipo de Arquivo")

Tipo de arquivo (indicado pela propriedade Extension ).

Por exemplo, é provável que um arquivo .mdb tenha o tipo de arquivo Microsoft Access Application. Um arquivo .asp provavelmente tem o tipo de arquivo Documento HTML. As pastas normalmente são relatadas simplesmente como Pasta.

Essa propriedade é herdada de CIM_LogicalFile.

FSCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Nome da Classe do Sistema de Arquivos")

Classe do sistema de arquivos.

Essa propriedade é herdada de CIM_LogicalFile.

FSName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Nome do Sistema de Arquivos")

Tipo de sistema de arquivos (NTFS, FAT, FAT32) instalado na unidade em que o arquivo ou pasta está localizado.

Essa propriedade é herdada de CIM_LogicalFile.

Oculto

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Oculto")

Indica se o objeto do sistema de arquivos está oculto. Se True, o arquivo ficará oculto.

Essa propriedade é herdada de CIM_LogicalFile.

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.

InUseCount

Tipo de dados: uint64
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Contagem aberta de arquivo atual")

Número de "arquivo aberto" que estão ativos no momento no arquivo.

Essa propriedade é herdada de CIM_LogicalFile.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

LastAccessed

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Último Acessado")

Data em que o arquivo foi acessado pela última vez. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.

Essa propriedade é herdada de CIM_LogicalFile.

Lastmodified

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Última modificação")

Data em que o arquivo foi modificado pela última vez. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.

Essa propriedade é herdada de CIM_LogicalFile.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

A propriedade Name é uma cadeia de caracteres que representa o nome herdado que serve como uma chave de uma instância de arquivo lógico dentro de um sistema de arquivos. Os nomes de caminho completo devem ser fornecidos. Exemplo: C:\Windows\system\win.ini

Essa propriedade é herdada de CIM_LogicalFile.

Caminho

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Caminho")

Caminho para o arquivo. O caminho inclui as barras invertidas à esquerda e à direita, mas não a letra da unidade ou o nome da pasta.

Para a pasta c:\windows\system32\wbem, o caminho é \windows\system32\. Para a pasta c:\scripts, o caminho é \.

Essa propriedade é herdada de CIM_LogicalFile.

Legível

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Legível")

Indica se você pode ler itens na pasta. Se True, o arquivo poderá ser lido.

Essa propriedade é herdada de CIM_LogicalFile.

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.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

System

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Arquivo do Sistema")

Indica se o objeto é um arquivo do sistema. Se true, o arquivo é um arquivo do sistema

Essa propriedade é herdada de CIM_LogicalFile.

Gravável

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Gravável")

Se True, o arquivo poderá ser gravado.

Essa propriedade é herdada de CIM_LogicalFile.

Comentários

A classe Win32_Directory é derivada de CIM_Directory.

Visão geral

Pastas são objetos do sistema de arquivos projetados para conter outros objetos do sistema de arquivos. No entanto, isso não significa que todas as pastas sejam iguais. Em vez disso, as pastas podem variar consideravelmente. Algumas pastas são pastas do sistema operacional, que geralmente não devem ser modificadas por um script. Algumas pastas são somente leitura, o que significa que os usuários podem acessar o conteúdo dessa pasta, mas não podem adicionar, excluir ou modificar esses conteúdos. Algumas pastas são compactadas para armazenamento ideal, enquanto outras ficam ocultas e não são visíveis para os usuários.

O WMI usa a classe Win32_Directory para gerenciar pastas. Significativamente, as propriedades e os métodos disponíveis nessa classe são idênticos às propriedades e aos métodos disponíveis na classe CIM_DataFile , a classe usada para gerenciar arquivos. Isso significa que, depois de aprender a gerenciar pastas usando o WMI, você, sem nenhum trabalho extra, também saberá como gerenciar arquivos.

A classe de associação Win32_Subdirectory também é usada para gerenciar arquivos e pastas. A classe Win32_Subdirectory relaciona uma pasta e suas subpastas imediatas. Por exemplo, na estrutura de pastas C:\Scripts\Logs, Logs é uma subpasta de Scripts e Scripts é uma subpasta da pasta raiz C:\. No entanto, Os logs não são considerados uma subpasta de C:\.

Você pode recuperar as propriedades de qualquer pasta no sistema de arquivos usando a classe Win32_Directory . As propriedades disponíveis usando essa classe são mostradas na Tabela 11.1. Para recuperar as propriedades de uma única pasta, construa uma consulta WQL (Windows Query Language) para a classe Win32_Directory , certificando-se de incluir o nome da pasta. Por exemplo, essa consulta se associa à pasta D:\Archive:

Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"

Ao especificar um nome de arquivo ou pasta em uma consulta WQL, certifique-se de usar duas barras invertidas (\\) para separar componentes de caminho.

Se você quiser limitar a recuperação de dados a uma única unidade de disco, inclua uma cláusula Where especificando a letra da unidade. Por exemplo, essa consulta retorna uma lista de todas as pastas na unidade C:

"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"

Se você precisar enumerar todas as pastas em um computador, lembre-se de que essa consulta pode levar um longo tempo para ser concluída.

Exemplos

O exemplo de VBScript a seguir recupera as propriedades da pasta C:\Scripts.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
 Wscript.Echo "Archive: " & objFolder.Archive
 Wscript.Echo "Caption: " & objFolder.Caption
 Wscript.Echo "Compressed: " & objFolder.Compressed
 Wscript.Echo "Compression method: " & objFolder.CompressionMethod
 Wscript.Echo "Creation date: " & objFolder.CreationDate
 Wscript.Echo "Encrypted: " & objFolder.Encrypted
 Wscript.Echo "Encryption method: " & objFolder.EncryptionMethod
 Wscript.Echo "Hidden: " & objFolder.Hidden
 Wscript.Echo "In use count: " & objFolder.InUseCount
 Wscript.Echo "Last accessed: " & objFolder.LastAccessed
 Wscript.Echo "Last modified: " & objFolder.LastModified
 Wscript.Echo "Name: " & objFolder.Name
 Wscript.Echo "Path: " & objFolder.Path
 Wscript.Echo "Readable: " & objFolder.Readable
 Wscript.Echo "System: " & objFolder.System
 Wscript.Echo "Writeable: " & objFolder.Writeable
Next

O exemplo de VBScript a seguir retorna uma lista de todas as pastas ocultas em um computador.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Hidden = True")
For Each objFile in colFiles
 Wscript.Echo objFile.Name
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_Directory
Classes do sistema operacional

Compartilhar via

Classe Win32_Directory

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais