classe CIM_LogicalFile

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

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