IFsiNamedStreams::get_Item 메서드(imapi2fs.h)
파일 시스템 이미지의 파일과 연결된 단일 명명된 스트림을 검색합니다.
구문
HRESULT get_Item(
[in] LONG index,
[out, optional] IFsiFileItem2 **item
);
매개 변수
[in] index
이 값은 컬렉션 내에서 명명된 스트림의 위치를 나타냅니다. 인덱스 번호는 0부터 시작합니다. 즉, 첫 번째 항목은 컬렉션의 위치 0에 있습니다.
[out, optional] item
인덱스로 지정된 위치에서 명명된 스트림을 나타내는 IFsiFileItem2 개체에 대한 포인터에 대한 포인터입니다. 지정된 인덱스가 컬렉션 경계 내에 없는 경우 이 매개 변수는 NULL 로 설정됩니다.
반환 값
S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
포인터가 잘못되었습니다. |
|
'%1!ls!' 매개 변수에 지정된 값입니다. 잘못되었습니다. |
설명
인덱스 번호가 음수이거나 범위를 벗어나면 이 메서드는 IMAPI_E_INVALID_PARAM 반환합니다.
파일과 연결된 모든 명명된 스트림에 대한 IEnumVARIANT 열거자를 가져오려면 IFsiNamedStreams::get__NewEnum 메서드를 사용합니다.
이 방법은 Windows Server 2003 SP1(서비스 팩 1), Windows XP SP2(서비스 팩 2) 및 Windows Vista에서 스토리지용 Windows 기능 팩을 통해 지원됩니다. 이 업데이트 패키지에서 제공하는 모든 기능은 기본적으로 Windows 7 및 Windows Server 2008 R2에서 지원됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi2fs.h |