IEnumEnhancedStorageACT::GetMatchingACT 메서드(ehstorapi.h)

클라이언트에서 제공하는 문자열을 통해 지정된 볼륨과 연결된 ACT(Addressable Command Target)를 반환합니다.

구문

HRESULT GetMatchingACT(
  [in]  LPCWSTR             szVolume,
  [out] IEnhancedStorageACT **ppIEnhancedStorageACT
);

[in] szVolume

일치하는 ACT가 검색되는 볼륨을 지정하는 문자열입니다.

[out] ppIEnhancedStorageACT

일치하는 ACT를 나타내는 IEnhancedStorageACT 인터페이스 포인터에 대한 포인터입니다. 일치하는 ACT가 없으면 오류 HRESULT_FROM_WIN32(ERROR_NOT_FOUND) 가 반환됩니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	일치하는 ACT가 성공적으로 발견되었습니다.
E_INVALIDARG	szVolume 또는 ppIEnhancedStorageACT 는 NULL입니다.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	일치하는 ACT를 찾을 수 없습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	향상된 스토리지는 szVolume을 포함하는 디바이스에서 지원되지 않습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_FUNCTION)	향상된 스토리지는 szVolume을 포함하는 디바이스에서 지원되지 않습니다.

클라이언트에서 이 메서드를 사용하여 지정된 볼륨이 상주하고 IEEE 1667 ACT로 표시되는지 확인할 수도 있습니다.