IVdsLunControllerPorts::AssociateControllerPorts 메서드(vds.h)
[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]
LUN과 관련하여 하위 시스템 컨트롤러 포트를 활성 또는 비활성으로 설정합니다. 이 메서드는 IVdsLun::AssociateControllers를 대체합니다.
구문
HRESULT AssociateControllerPorts(
VDS_OBJECT_ID *pActiveControllerPortIdArray,
LONG lNumberOfActiveControllerPorts,
VDS_OBJECT_ID *pInactiveControllerPortIdArray,
LONG lNumberOfInactiveControllerPorts
);
매개 변수
pActiveControllerPortIdArray
컨트롤러 포트 GUID 배열에 대한 포인터입니다. 공급자는 이러한 컨트롤러 포트를 활성으로 설정합니다. 이 배열에는 활성 상태로 유지되도록 이미 활성으로 설정된 컨트롤러 포트가 포함됩니다.
lNumberOfActiveControllerPorts
pActiveControllerPortIdArray 매개 변수에 지정된 컨트롤러 포트 수입니다.
pInactiveControllerPortIdArray
컨트롤러 포트 GUID 배열에 대한 포인터입니다. 공급자는 이러한 컨트롤러 포트를 비활성으로 설정합니다. 이 배열에는 비활성 상태로 유지되도록 이미 비활성으로 설정된 컨트롤러 포트가 포함됩니다.
lNumberOfInactiveControllerPorts
pInactiveControllerPortIdArray 매개 변수에 지정된 컨트롤러 포트 수입니다.
반환 값
이 메서드는 표준 HRESULT 값(예: E_INVALIDARG 또는 E_OUTOFMEMORY) 및 VDS 관련 반환 값을 반환할 수 있습니다. 또한 HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
연결 이름이 성공적으로 설정되었습니다. |
|
공급자의 캐시가 손상되었습니다. 연결된 디바이스에 대한 정보를 캐시하는 공급자 내의 소프트웨어 또는 통신 문제를 나타냅니다. 호출자는 IVdsHwProvider::Reenumerate 메서드와 IVdsHwProvider::Refresh 메서드를 사용하여 캐시를 복원할 수 있습니다. |
|
LUN 개체가 더 이상 존재하지 않습니다. |
|
LUN이 실패 상태이며 요청된 작업을 수행할 수 없습니다. |
|
다른 작업이 진행 중입니다. 이 작업은 이전 작업이 완료될 때까지 진행할 수 없습니다. |
|
pActiveControllerPortIdArray 또는 pInactiveControllerPortIdArray 매개 변수에 지정된 하나 이상의 데이터 형식 VDS_OBJECT_ID GUID는 기존 개체를 참조하지 않습니다. |
|
이 작업 또는 매개 변수 조합은 이 공급자에서 지원되지 않습니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista[데스크톱 앱 전용] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vds.h |
| 재배포 가능 파일 | VDS 1.1 |