MSFT_StorageSubSystem 클래스의 CreateMaskingSet 메서드
새 마스킹 집합을 만듭니다.
마스킹 집합은 컴퓨터를 호스트하는 가상 디스크를 표시하기 위한 목적으로 가상 디스크, 대상 포트 및 초기자의 논리적 그룹화입니다.
구문
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]
마스킹 집합의 초기자에게 표시할 가상 디스크 목록입니다. 각 디스크는 해당 MSFT_VirtualDisk 개체의 Name 속성에 저장된 식별자에 의해 지정되어야 합니다.
이 매개 변수에는 DeviceAccesses 매개 변수와 1:1 매핑이 있습니다. 두 배열의 길이는 같아야 하며 요소는 동일한 순서로 정렬되어야 합니다.
DeviceAccesses [in]
VirtualDiskNames 매개 변수에 지정된 각 가상 디스크에 대해 초기자가 가져야 하는 액세스 수준입니다. 이 매개 변수에는 VirtualDiskNames 매개 변수와 1:1 매핑이 있습니다. 두 배열의 길이는 같아야 하며 요소는 동일한 순서로 정렬되어야 합니다.
알 수 없음 (0)
읽기 쓰기 (2)
읽기 전용 (3)
액세스 없음 (4)
DeviceNumbers [in]
초기자에 가상 디스크를 표시해야 하는 순서를 지정합니다. 이 기능은 스토리지 하위 시스템의 MaskingClientSelectableDeviceNumbers 속성이 TRUE인 경우에만 사용할 수 있습니다. 지정한 경우 이 매개 변수에는 VirtualDiskNames 매개 변수와 1:1 매핑이 있어야 합니다.
TargetPortAddresses [in]
초기자에 가상 디스크를 표시할 때 사용할 대상 포트입니다. 지정할 수 있는 대상 포트 수는 하위 시스템의 MaskingPortsPerView 속성에 따라 달라집니다. MaskingPortsPerView가 모든 대상 포트가 동일한 보기를 공유하는 경우 이 매개 변수는 무시되고 시스템의 모든 대상 포트는 이 마스킹 집합과 연결됩니다.
InitiatorAddresses [in]
가상 디스크를 표시해야 하는 초기자입니다. 하위 시스템의 MaskingOneInitiatorIdPerView 속성이 TRUE이면 이 마스킹 집합에 대해 하나의 초기자만 지정할 수 있습니다. 유효한 초기자 주소 형식 목록은 하위 시스템의 MaskingValidInitiatorIdTypes 속성에 의해 지정됩니다.
HostType [in]
초기자에 가상 디스크를 표시할 때 스토리지 시스템에 있어야 하는 동작에 영향을 줄 수 있는 호스트 운영 체제 또는 기타 호스트 환경 요소입니다.
22에서 32767(포함) 사이의 값은 DMTF용으로 예약되어 있습니다. 32768에서 65535(포함) 사이의 값은 공급업체용으로 예약되어 있습니다.
알 수 없음 (0)
기타 (1)
표준 (2)
솔라리스 (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
순차적 (8)
AIX (9)
DGUX (10)
다이닉스 (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 예약 됨(22..32767)
공급업체별 (32768..65535)
RunAsJob [in]
TRUE이면 요청이 서비스에 오래 걸리는 경우 이 메서드는 CreatedStorageJob 매개 변수를 사용합니다. 작업을 추적하기 위해 스토리지 작업을 만든 경우 이 메서드는 메서드 매개 변수 선택됨 - 작업이 시작된 것을 반환합니다.
참고
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 |