시작 및 서비스 개체

[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]

VDS는 서비스 관련 작업을 수행하기 위한 개체를 제공합니다. 이 항목에서는 각 개체에 대해 설명합니다.

서비스 로더 개체

서비스 로더 개체는 애플리케이션에서 VDS를 로드하고 초기화하는 데 사용하는 메서드를 제공합니다. 사용할 VDS를 준비하려면 애플리케이션에서 다음 작업을 수행해야 합니다.

코드 예제는 VDS 로드를 참조하세요.

서비스 개체에 의해 노출되는 메서드를 호출하기 전에 항상 서비스가 완전히 초기화되도록 허용합니다. IVdsService::IsServiceReady 메서드를 사용하여 로드 프로세스의 상태를 확인합니다. 초기화가 완료될 때까지 IVdsService::WaitForServiceReady 메서드를 사용하여 VDS 개체에 대한 호출을 차단합니다.

다음 표에는 관련 인터페이스, 열거형 및 구조체가 나와 있습니다.

형식 요소
이 개체에 의해 항상 노출되는 인터페이스 IVdsServiceLoader.
연결된 열거형 없음.
연결된 구조체 없음.

 

서비스 개체

서비스 개체는 모든 VDS 애플리케이션의 중심인 다기능 개체입니다. 이 개체를 사용하면 호출자가 다음 작업을 수행할 수 있습니다.

  • 서비스 초기화의 상태를 확인합니다.
  • VDS에 등록된 모든 하드웨어 또는 소프트웨어 공급자를 검색합니다.
  • 할당되지 않은 디스크에 대해 보고합니다.
  • 디스크의 볼륨과 연결된 파일 시스템 유형 및 드라이브 문자를 반환합니다.
  • 레지스트리에서 사용되지 않는 사용자 모드 경로 및 탑재된 폴더를 제거하고 디스크를 새로 고칩니다.
  • VDS 알림을 받습니다.
  • 호스트를 다시 부팅합니다.
  • 로컬 컴퓨터에서 파이버 채널 HBA 포트 또는 iSCSI 초기자 어댑터를 검색합니다.
  • 제거를 위해 로컬 컴퓨터에서 디스크로 노출된 LUN을 안전하게 준비합니다.

VDS 알림 구조는 알림을 수신하기 위해 VDS에 등록된 모든 애플리케이션에 개체 GUID를 전달합니다. IVdsService::GetObject 메서드를 사용하여 개체 GUID를 개체 포인터로 변환합니다. 알림 모델에 대한 자세한 설명은 VDS 알림을 참조하세요.

다음 표에는 관련 인터페이스, 열거형 및 구조체가 나와 있습니다.

형식 요소
이 개체에 의해 항상 노출되는 인터페이스 IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*.
항상 구현되지만 애플리케이션에 노출되지 않는 인터페이스 IVdsAdmin
연결된 열거형 VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG.
연결된 구조체 VDS_SERVICE_PROP, VDS_FILE_SYSTEM_PROP, VDS_FILE_SYSTEM_TYPE_PROP, VDS_DRIVE_LETTER_NOTIFICATION, VDS_FILE_SYSTEM_NOTIFICATION, VDS_MOUNT_POINT_NOTIFICATION.

 

*Windows Server 2003: 이러한 인터페이스는 Windows Server 2003 R2까지 지원되지 않습니다.

초기자 어댑터 개체

초기자 어댑터 개체는 VDS 서비스의 호스트 컴퓨터에서 iSCSI 초기자 어댑터를 모델링합니다. VDS 서비스는 로컬 컴퓨터에서 초기자 어댑터만 볼 수 있습니다. 초기자 어댑터 개체의 역할은 로컬 컴퓨터에서 iSCSI 대상으로 로그인 세션을 관리하는 것입니다.

다음 표에는 관련 인터페이스, 열거형 및 구조체가 나와 있습니다.

형식 요소
이 개체에 의해 항상 노출되는 인터페이스 IVdsIscsiInitiatorAdapter*.
연결된 열거형 VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE.
연결된 구조체 VDS_ISCSI_INITIATOR_ADAPTER_PROP.

 

*Windows Server 2003: 이 인터페이스는 Windows Server 2003 R2까지 지원되지 않습니다.

초기자 포털 개체

초기자 포털 개체는 iSCSI 초기자에서 iSCSI 초기자 포털을 모델링합니다. 초기자 포털은 호스트 컴퓨터가 iSCSI 하위 시스템의 포털에 연결하는 IP 주소와 포트의 조합입니다. 초기자 포털 개체의 역할은 MPIO 경로의 엔드포인트 중 하나로 사용되며 IPSEC 보안 설정을 구성하는 것입니다.

다음 표에는 관련 인터페이스, 열거형 및 구조체가 나와 있습니다.

형식 요소
이 개체에 의해 항상 노출되는 인터페이스 IVdsIscsiInitiatorPortal*.
연결된 열거형 VDS_ISCSI_IPSEC_FLAG.
연결된 구조체 VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS.

 

*Windows Server 2003: 이 인터페이스는 Windows Server 2003 R2까지 지원되지 않습니다.

HBA 포트 개체

HBA 포트 개체는 HBA(파이버 채널 호스트 버스 어댑터) 포트를 모델링합니다.

IVdsServiceHba::QueryHbaPorts 메서드를 사용하여 로컬 컴퓨터의 VDS에 알려진 HBA 포트를 확인합니다.

다음 표에는 관련 인터페이스, 열거형 및 구조체가 나와 있습니다.

형식 요소
이 개체에 의해 항상 노출되는 인터페이스 IVdsHbaPort*.
연결된 열거형 VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG.
연결된 구조체 VDS_HBAPORT_PROP.

 

*Windows Server 2003: 이 인터페이스는 Windows Server 2003 R2까지 지원되지 않습니다.

VDS 개체 모델

IVdsServiceLoader::LoadService

VD 로드

IVdsService::GetObject

VDS 알림