IFsiFileItem2::AddStream 메서드(imapi2fs.h)
명명된 스트림을 파일 시스템 이미지의 특정 파일과 연결합니다.
구문
HRESULT AddStream(
[in] BSTR name,
[in] IStream *streamData
);
매개 변수
[in] name
문자열은 명명된 스트림의 이름을 나타냅니다. 이 경로는 포함하지 않아야 하며 파일 시스템 명명 규칙에 따라 유효한 문자만 포함해야 합니다.
[in] streamData
결과 파일 시스템 이미지에 쓰는 데 사용되는 명명된 스트림의 IStream 인터페이스입니다.
반환 값
S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
기능은 현재 파일 시스템 수정 버전에 대해 지원되지 않으므로 이 기능 없이 생성됩니다. |
|
포인터가 잘못되었습니다. |
|
'%1!ls!' 매개 변수에 지정된 값입니다. 잘못되었습니다. |
|
ls!' 가 파일 시스템의 일부가 아닙니다. 이 작업을 완료하려면 추가해야 합니다. |
|
참조된 IFileSystemImage 개체는 읽기 전용 모드입니다. |
|
내부 파일 시스템 오류가 발생했습니다. |
|
'%1!ls!' 이름이 이미 있습니다. |
|
파일 '%1!ls!'에 제공된 스트림에서 데이터를 읽을 수 없습니다. |
|
'%1!ls!'을(를) 추가하면 결과 이미지의 크기가 현재 구성된 제한보다 커지게 됩니다. |
|
'%1!ls!' 파일에 제공된 데이터 스트림이 일치하지 않습니다. %2! I64d! %3!을(를) 찾았습니다. I64d! |
|
필요한 메모리를 할당하지 못했습니다. |
설명
명명된 스트림을 추가할 파일은 파일 시스템 이미지 내에 이미 있어야 합니다. 이 메서드가 명명된 스트림에 대해 이미 존재하는 이름으로 호출되면 오류가 반환되고 기존 명명된 스트림을 대체하지 않습니다.
결과 이미지에서 만들 수 있도록 설정된 파일 시스템 목록에 UDF가 포함되지 않은 파일 시스템 개체에 대해 이 메서드가 호출되거나 UDF 수정 버전이 2.00 미만인 경우 이 메서드는 IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED 성공 코드를 반환합니다. 이 성공 코드는 명명된 스트림이 추가되었지만 파일 시스템 개체에서 UDF 수정 버전 2.00 이상을 사용하도록 설정하지 않으면 결과 파일 시스템 이미지에 표시되지 않음을 나타냅니다.
현재 IMAPI_E_READONLY 이미지의 읽기 전용 상태 관계없이 가져온 파일 시스템 이미지에서 이 메서드를 호출할 때 반환됩니다.
이 방법은 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 |