classe CIM_LogicalFile

Artigo
06/13/2023

A classe CIM_LogicalFile representa uma coleção nomeada de dados, que pode ser código executável, localizada em um sistema de arquivos em uma extensão de armazenamento.

Importante

As classes CIM (Modelo de Informações Comuns) do DMTF (Distributed Management Task Force) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão CIM 2.x.

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

[SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C559-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("Files (CIM)"), AMENDMENT]
class CIM_LogicalFile : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  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   Name;
  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 CIM_LogicalFile tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe CIM_LogicalFile tem esses métodos.

Método	Descrição
ChangeSecurityPermissions	Altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. Não implementado pelo WMI.
ChangeSecurityPermissionsEx	Altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. Não implementado pelo WMI.
Comprimir	Compacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
CompressEx	Compacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
Copiar	Copia o arquivo lógico (ou diretório) especificado no caminho do objeto para o local especificado pelo parâmetro de entrada. Não implementado pelo WMI.
CopyEx	Copia o arquivo lógico (ou diretório) especificado no caminho do objeto para o local especificado pelo parâmetro de entrada. Não implementado pelo WMI.
Excluir	Exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
DeleteEx	Exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
GetEffectivePermission	Determina se o chamador tem as permissões agregadas especificadas pelo argumento Permission . Não implementado pelo WMI.
Renomear	Renomeia o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
Takeownership	Obtém a propriedade do arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
TakeOwnerShipEx	Obtém a propriedade do arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
Descompactar	Descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.
UncompressEx	Descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Não implementado pelo WMI.

Propriedades

A classe CIM_LogicalFile 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 arquivo. 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.

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

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

FILE_APPEND_DATA (arquivo) ou FILE_ADD_SUBDIRECTORY (diretório) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

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

FILE_DELETE_CHILD (diretório) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Arquivar

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

Se True, o arquivo deverá ser arquivado.

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

Se True, o arquivo será compactado.

CompressionMethod

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

Cadeia de caracteres de forma livre que indica o algoritmo ou a ferramenta usada para compactar o arquivo lógico. Se o esquema de compactação for desconhecido ou não descrito, use "Desconhecido". Se o arquivo lógico for compactado, mas o esquema de compactação for desconhecido ou não descrito, use "Compactado". Se o arquivo lógico não for compactado, use "Não compactado".

CreationClassName

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

Nome da classe.

CreationDate

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

Data e hora da criação do arquivo.

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

Classe do sistema de computador.

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 sistema de computador.

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 da unidade (incluindo os dois-pontos que seguem a letra da unidade) do arquivo. Essa propriedade é herdada de CIM_LogicalFile. Exemplo: "c:"

EightDotThreeFileName

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

Nome do arquivo compatível com DOS. Exemplo: "c:\progra~1"

Criptografado

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

Se True, o arquivo será criptografado.

Encryptionmethod

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

Cadeia de caracteres de forma livre que identifica o algoritmo ou a ferramenta usada para criptografar um arquivo lógico. Se o esquema de criptografia não for entregue (por motivos de segurança, por exemplo), use "Desconhecido". Se o arquivo for criptografado, mas seu esquema de criptografia for desconhecido ou não for divulgado, use "Criptografado". Se o arquivo lógico não estiver criptografado, use "Não Criptografado".

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 sem o período anterior (ponto). Exemplo: "txt", "mof", "mdb"

FileName

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

Nome do arquivo sem a extensão de nome de arquivo. Exemplo: "MyDataFile"

FileSize

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

Tamanho do arquivo, em bytes.

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

FileType

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

Descritor que representa o tipo de arquivo indicado pela propriedade Extension .

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.

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

Nome do sistema de arquivos.

Oculto

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

Se True, o arquivo ficará oculto.

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.

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 e hora em que o arquivo foi acessado pela última vez.

Lastmodified

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

Data e hora em que o arquivo foi modificado pela última vez.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Substituição ("Nome"), 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

Caminho

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

Caminho do arquivo, incluindo as barras invertidas à esquerda e à direita. Exemplo: "\windows\system\"

Legível

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

Se True, o arquivo poderá ser lido.

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. Os 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")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

System

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

Se True, o arquivo será um arquivo do sistema.

Gravável

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Writeable")

Se True, o arquivo poderá ser gravado.

Comentários

A classe CIM_LogicalFile é derivada de CIM_LogicalElement.

O WMI não implementa essa classe. Para classes derivadas de CIM_LogicalFile, consulte Classes Win32.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

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

Compartilhar via

classe CIM_LogicalFile

Sintaxe

Membros

Métodos

Propriedades

Comentários

Requisitos

Confira também

Comentários

Recursos adicionais