Класс Win32_ShortcutFile

Статья
06/12/2023

Класс WMIWin32_ShortcutFile представляет файлы, которые являются ярлыками для других файлов, каталогов и команд.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Dynamic, Provider("CIMWin32"), UUID("{F25FE466-783E-11d2-90BF-0060081A46FD}"), AMENDMENT]
class Win32_ShortcutFile : CIM_DataFile
{
  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;
  string   Manufacturer;
  string   Version;
  string   Target;
};

Члены

Класс Win32_ShortcutFile имеет следующие типы членов:

Методы
Свойства

Методы

Класс Win32_ShortcutFile содержит следующие методы.

Метод	Описание
ChangeSecurityPermissions	Метод класса, который изменяет разрешения безопасности для логического файла, указанного в пути к объекту.
ChangeSecurityPermissionsEx	Метод класса, который изменяет разрешения безопасности для логического файла, указанного в пути к объекту.
Сжать	Метод класса, который сжимает логический файл (или каталог), указанный в пути к объекту.
CompressEx	Метод класса, который сжимает логический файл (или каталог), указанный в пути к объекту.
Копировать	Метод класса, копирующий логический файл или каталог, указанный в пути к объекту, в расположение, указанное входным параметром.
CopyEx	Метод класса, копирующий логический файл или каталог, указанный в пути к объекту, в расположение, указанное параметром FileName .
Удалить	Метод класса, который удаляет логический файл (или каталог), указанный в пути к объекту.
DeleteEx	Метод класса, который удаляет логический файл (или каталог), указанный в пути к объекту.
GetEffectivePermission	Метод класса, который определяет, имеет ли вызывающий объект агрегированные разрешения, заданные аргументом Permission, не только для объекта file, но и для общей папки, в которой находится файл или каталог (если он находится в общей папке).
Переименовать	Метод класса, который переименовывает логический файл (или каталог), указанный в пути к объекту.
TakeOwnerShip	Метод класса, который получает право владения логическим файлом, указанным в пути к объекту.
TakeOwnerShipEx	Метод класса, который получает право владения логическим файлом, указанным в пути к объекту.
Распаковать	Метод класса, который распаковывает логический файл (или каталог), указанный в пути к объекту.
UncompressEx	Метод класса, который распаковывает логический файл (или каталог), указанный в пути к объекту.

Свойства

Класс Win32_ShortcutFile имеет следующие свойства.

AccessMask

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Access Rights")

Битовая маска, представляющая права доступа, необходимые для доступа к файлу или выполнения определенных операций. Битовые значения см. в разделе Константы прав доступа к файлам и каталогам.

Примечание

На томах FAT вместо этого возвращается значение FULL_ACCESS , указывающее, что для объекта не задана безопасность.

Это свойство наследуется от CIM_LogicalFile.

FILE_READ_DATA (файл) или FILE_LIST_DIRECTORY (каталог) (1)

FILE_WRITE_DATA (файл) или FILE_ADD_FILE (каталог) (2)

FILE_APPEND_DATA (файл) или FILE_ADD_SUBDIRECTORY (каталог) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (файл) или FILE_TRAVERSE (каталог) (32)

FILE_DELETE_CHILD (каталог) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Архив

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Следует архивировать")

Если задано значение True, файл должен быть архивирован.

Это свойство наследуется от CIM_LogicalFile.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Compressed

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Сжатый")

Если задано значение True, файл сжимается.

Это свойство наследуется от CIM_LogicalFile.

CompressionMethod

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Метод сжатия")

Строка свободной формы, указывающая алгоритм или средство, используемое для сжатия логического файла. Если схема сжатия неизвестна или не описана, используйте команду "Unknown". Если логический файл сжат, но схема сжатия неизвестна или не описана, используйте "Сжатый". Если логический файл не сжат, используйте команду "Не сжатый".

Это свойство наследуется от CIM_LogicalFile.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key, DisplayName ("Имя класса")

Имя класса.

Это свойство наследуется от CIM_LogicalFile.

CreationDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Дата создания")

Дата и время создания файла.

Это свойство наследуется от CIM_LogicalFile.

CSCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Распространяется ("CIM_FileSystem. CSCreationClassNameCIM_Key,DisplayName ("Computer System Class Name")

Класс компьютерной системы.

Это свойство наследуется от CIM_LogicalFile.

CSName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Распространяется ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Имя системы компьютера")

Имя компьютерной системы.

Это свойство наследуется от CIM_LogicalFile.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Диске

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Диск")

Буква диска (включая двоеточие, следующее за буквой диска) файла.

Пример: "c:"

Это свойство наследуется от CIM_LogicalFile.

EightDotThreeFileName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Восемь точек три имени файла")

Имя файла в формате 8.3.

Пример: "c:\progra~1"

Это свойство наследуется от CIM_LogicalFile.

Зашифрована

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Encrypted")

Если задано значение True, файл зашифрован.

Это свойство наследуется от CIM_LogicalFile.

EncryptionMethod

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Метод шифрования")

Строка свободной формы, идентифицирующая алгоритм или средство, используемое для шифрования логического файла. Если схема шифрования не используется (например, по соображениям безопасности), используйте "Неизвестно". Если файл зашифрован, но его схема шифрования неизвестна или не разглашается, используйте "Зашифровано". Если логический файл не зашифрован, используйте "Не зашифровано".

Это свойство наследуется от CIM_LogicalFile.

Расширение

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Расширение файла")

Расширение имени файла без предыдущей точки (точка).

Пример: "txt", "mof", "mdb"

Это свойство наследуется от CIM_LogicalFile.

FileName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Имя файла")

Имя файла без расширения имени файла.

Пример: "MyDataFile"

Это свойство наследуется от CIM_LogicalFile.

FileSize

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Size"), Units ("байты")

Размер файла в байтах.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

Это свойство наследуется от CIM_LogicalFile.

FileType

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Тип файла")

Дескриптор, представляющий тип файла, указанный свойством Extension .

Это свойство наследуется от CIM_LogicalFile.

FSCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Распространяется ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Имя класса файловой системы")

Класс файловой системы.

Это свойство наследуется от CIM_LogicalFile.

FSName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Распространяется ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Имя файловой системы")

Имя файловой системы.

Это свойство наследуется от CIM_LogicalFile.

Скрыта

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Hidden")

Если задано значение True, файл скрыт.

Это свойство наследуется от CIM_LogicalFile.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

InUseCount

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Текущее число открытых файлов")

Число открытых файлов, которые в настоящее время активны для файла.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Создание скриптов в WMI.

Это свойство наследуется от CIM_LogicalFile.

LastAccessed

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Последний доступ")

Дата и время последнего доступа к файлу.

Это свойство наследуется от CIM_LogicalFile.

LastModified

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Последнее изменение")

Дата и время последнего изменения файла.

Это свойство наследуется от CIM_LogicalFile.

Производителя

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Manufacturer")

Строка производителя из ресурса версии (если она присутствует).

Это свойство наследуется от CIM_DataFile.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Свойство Name — это строка, представляющая наследуемое имя, которое служит ключом экземпляра логического файла в файловой системе. Необходимо указать полные имена путей.

Пример: C:\Windows\system\win.ini

Это свойство наследуется от CIM_LogicalFile.

Путь

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Fixed, Schema ("Win32"), DisplayName ("Path")

Путь к файлу, включая начальные и конечные обратные косые знаки.

Пример: "\windows\system\"

Это свойство наследуется от CIM_LogicalFile.

Читаемым

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Readable")

Если задано значение True, файл может быть прочитан.

Это свойство наследуется от CIM_LogicalFile.

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочее состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой pred". "Pred Fail" указывает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние "Нерабочее" может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время повторного зеркало диска, перезагрузки списка разрешений пользователя или выполнения других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Error ("Error")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

Системные функции

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Системный файл")

Если задано значение True, файл является системным.

Это свойство наследуется от CIM_LogicalFile.

Целевой объект

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API|_beginthreadex")

Имя объекта, к которому это ярлык.

Версия

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32"), DisplayName ("Версия")

Строка версии из ресурса версии (если она присутствует).

Это свойство наследуется от CIM_DataFile.

Writeable (Доступно для записи)

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Writeable")

Если задано значение True, файл можно записать.

Это свойство наследуется от CIM_LogicalFile.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_DataFile
Классы операционной системы

Поделиться через

Класс Win32_ShortcutFile

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы