Метод CreateMaskingSet класса MSFT_StorageSubSystem
Создает новый набор для маски.
Набор маскирования — это логическая группа виртуальных дисков, целевых портов и инициаторов с целью отображения виртуальных дисков для размещения компьютеров.
Синтаксис
UInt32 CreateMaskingSet(
[in] String FriendlyName,
[in] String VirtualDiskNames[],
[in] UInt16 DeviceAccesses[],
[in] String DeviceNumbers[],
[in] String TargetPortAddresses[],
[in] String InitiatorAddresses[],
[in] UInt16 HostType,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedMaskingSet,
[out] String ExtendedStatus
);
Параметры
FriendlyName [in]
Понятное имя для набора маскирования.
Понятные имена должны быть описательными, но они не обязательно должны быть уникальными.
Этот параметр является обязательным и не может иметь значение NULL.
VirtualDiskNames [in]
Список виртуальных дисков для отображения инициаторам в наборе маскирования. Каждый диск должен быть указан идентификатором, хранящимся в свойстве Name объекта MSFT_VirtualDisk .
Этот параметр имеет сопоставление 1:1 с параметром DeviceAccesses . Оба массива должны иметь одинаковую длину, а элементы должны располагаться в одном порядке.
DeviceAccesses [in]
Уровень доступа, который должен иметь инициатор к каждому виртуальному диску, указанному в параметре VirtualDiskNames . Этот параметр имеет сопоставление 1:1 с параметром VirtualDiskNames . Оба массива должны иметь одинаковую длину, а элементы должны располагаться в одном порядке.
Неизвестно (0)
Чтение записи (2)
Только для чтения (3)
Нет доступа (4)
DeviceNumbers [in]
Указывает порядок отображения виртуальных дисков инициаторам. Эта возможность доступна, только если свойство MaskingClientSelectableDeviceNumbers подсистемы хранения имеет значение TRUE. Если этот параметр указан, этот параметр должен иметь сопоставление 1:1 с параметром VirtualDiskNames .
TargetPortAddresses [in]
Целевые порты, используемые при отображении виртуальных дисков инициаторам. Количество целевых портов, которые можно указать, зависит от свойства MaskingPortsPerView подсистемы . Если параметр MaskingPortsPerView имеет значение Все целевые порты совместно используют одно представление, этот параметр игнорируется, а все целевые порты в системе связаны с этим набором маскирования.
InitiatorAddresses [in]
Инициаторы, для которых должны отображаться виртуальные диски. Если свойство MaskingOneInitiatorIdPerView подсистемы имеет значение TRUE, для этого набора маскирования может быть указан только один инициатор. Список допустимых форматов адресов инициатора определяется свойством MaskingValidInitiatorIdTypes подсистемы .
HostType [in]
Операционная система узла или другие факторы среды узла, которые могут повлиять на поведение системы хранения при отображении виртуального диска инициатору.
Значения от 22 до 32767 (включительно) зарезервированы для DMTF. Значения от 32768 до 65535 (включительно) зарезервированы для поставщиков.
Неизвестно (0)
Другое (1)
Стандартный (2)
Solaris (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
Последовательный (8)
AIX (9)
DGUX (10)
Dynix (11)
Irix (12)
Маршрутизатор хранилища Cisco iSCSI (13)
Linux (14)
Microsoft Windows (15)
OS400 (16)
TRESPASS (17)
HI-UX (18)
VMware ESXi (19)
Microsoft Windows Server 2008 (20)
Microsoft Windows Server 2003 (21)
DmTF Reserved (22..32767)
Конкретный поставщик (32768..65535)
RunAsJob [in]
Если задано значение TRUE, этот метод использует параметр CreatedStorageJob , когда обслуживание запроса занимает много времени. Если для отслеживания операции было создано задание хранилища, этот метод возвращает параметры метода Checked — Job Started .
Примечание
Даже если runAsJob имеет значение TRUE, этот метод по-прежнему может возвращать результат, если он был завершен в достаточное время.
Если значение РАВНО FALSE или NULL, этот метод будет следовать асинхронной реакции WMI по умолчанию, определяемой методом клиента для вызова. Другими словами, он является синхронным, если не запрошено иное.
CreatedStorageJob [out]
Если параметр RunAsJob имеет значение TRUE и выполнение этого метода занимает много времени, этот параметр получает ссылку на объект задания хранилища, который используется для отслеживания длительной операции.
CreatedMaskingSet [out]
Если набор маскирования успешно создан, этот параметр получает строку, содержащую внедренный объект MSFT_MaskingSet .
ExtendedStatus [out]
Строка, содержащая внедренный объект MSFT_StorageExtendedStatus .
Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.
Возвращаемое значение
Успешное выполнение (0)
Не поддерживается (1)
Неустановленная ошибка (2)
Время ожидания (3)
Сбой (4)
Недопустимый параметр (5)
Проверенные параметры метода — задание запущено (4096)
Доступ запрещен (40001)
Недостаточно ресурсов для завершения операции. (40002)
Не удается подключиться к поставщику хранилища. (46000)
Поставщик хранилища не может подключиться к подсистеме хранения. (46001)
Не удалось найти указанный виртуальный диск. (50000)
Указанный номер устройства недопустим. (52000)
Запрошенный HostType не поддерживается. (52001)
DeviceAccess необходимо указать для каждого виртуального диска. (52002)
Указанный адрес инициатора недопустим (53000)
Для этой операции допустим только один адрес инициатора. (53001)
Указанный адрес целевого порта недопустим. (54000)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Пространство имен | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |