IVdsVolumeMF::AddAccessPath 메서드(vds.h)

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

액세스 경로를 추가합니다.

구문

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

[in] pwszPath

볼륨을 여는 데 사용할 수 있는 사용자 모드 경로인 액세스 경로를 나타내는 문자열입니다. 액세스 경로는 드라이브 문자 또는 NTFS 볼륨의 빈 디렉터리에 대한 경로일 수 있습니다. 액세스 경로 문자열에는 후행 백슬래시(예: "F:")가 포함되어야 합니다.

이 메서드는 E_INVALIDARG 또는 E_OUTOFMEMORY 같은 표준 HRESULT 값과 VDS별 반환 값을 반환할 수 있습니다. HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값	Description
S_OK	경로가 성공적으로 추가되었습니다.
S_FALSE	액세스 경로가 성공적으로 추가되었지만 오류가 발생했습니다. VDS가 파티션의 GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER 특성을 업데이트하지 못했거나 드라이브 문자를 추가하는 동안 기본 네트워크 공유(예: F$)를 추가하지 못했을 수 있습니다. 자세한 내용은 PARTITION_INFORMATION_GPT 참조하세요.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	볼륨이 실패했습니다.
VDS_E_PACK_OFFLINE 0x80042444L	볼륨을 포함하는 팩에 액세스할 수 없습니다.

VDS는 탑재된 폴더(볼륨 탑재 지점이라고도 함)를 만들어 액세스 경로를 추가합니다. 탑재된 폴더는 NTFS 볼륨에서만 지원됩니다. 자세한 내용은 탑재된 폴더를 참조하세요.

이 메서드는 pwszPath 매개 변수에 이미 사용 중인 탑재된 폴더에 대한 경로가 포함되어 있거나(디렉터리가 비어 있더라도) pwszPath 에 비어 있지 않은 디렉터리에 대한 경로가 포함된 경우 ERROR_DIR_NOT_EMPTY 반환합니다.