IFsiDirectoryItem::get_Item 메서드(imapi2fs.h)

파일 시스템 이미지에서 지정된 디렉터리 또는 파일 항목을 검색합니다.

구문

HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

매개 변수

[in] path

검색할 항목의 경로를 포함하는 문자열입니다.

[out] item

요청된 디렉터리 또는 파일 항목의 IFsiItem 인터페이스입니다.

반환 값

S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.

반환 코드	설명
IMAPI_E_INVALID_PATH	경로 '%1!s!' 형식이 잘못되었거나 잘못된 문자가 포함되어 있습니다. 값: 0xC0AAB110
E_POINTER	포인터가 잘못되었습니다. 값: 0x80004003
IMAPI_E_INVALID_PARAM	%1!ls! 매개 변수에 지정된 값이 잘못되었습니다. 값: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND	FileSystemImage 계층 구조에서 항목 %1!ls! 을(를) 찾을 수 없습니다. 값: 0xC0AAB118
E_OUTOFMEMORY	필요한 메모리를 할당하지 못했습니다. 값: 0x8007000E

설명

항목이 파일 항목인지 디렉터리 항목인지 확인하려면 인터페이스 식별자로 __uuidof( IFsiDirectoryItem)를 전달하는 IFsiItem::QueryInterface 메서드를 호출합니다. 호출이 성공하면 항목은 디렉터리 항목입니다. 그렇지 않으면 항목이 파일 항목입니다.

모든 자식을 열거하려면 IFsiDirectoryItem::get__NewEnum 메서드를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	imapi2fs.h

추가 정보

IFsiDirectoryItem

IFsiFileItem