IFileSystemImage2::p ut_BootImageOptionsArray 메서드(imapi2fs.h)

파일 시스템 이미지를 생성하는 데 사용할 부팅 옵션 배열을 설정합니다. IFileSystemImage::p ut_BootImageOptions와 달리 이 메서드는 각 부팅 옵션 배열 요소의 전체 복사본을 만들지 않고 대신 각 요소에 대한 참조를 사용합니다.

구문

HRESULT put_BootImageOptionsArray(
  [in] SAFEARRAY *newVal
);

매개 변수

[in] newVal

파일 시스템 이미지를 생성하는 데 사용할 부팅 이미지의 IBootOptions 인터페이스 목록입니다. 목록의 각 요소는 VT_DISPATCH 형식의 VARIANT입니다.

반환 값

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

반환 코드	설명
E_NOINTERFACE	해당 인터페이스는 지원되지 않습니다. 값: 0x80004002
IMAPI_E_BOOT_OBJECT_CONFLICT	부팅 개체는 초기 디스크 이미지에만 포함될 수 있습니다. 값: 0xC0AAB149
IMAPI_E_BOOT_IMAGE_DATA	부팅 개체를 이미지에 추가할 수 없습니다. 값: 0xC0AAB148

설명

SAFEARRAY는 1차원 배열이어야 합니다. 크기가 0인 배열은 허용되지만 부팅할 수 없는 일반 디스크가 생성됩니다.

디스크의 부팅 이미지 시퀀스는 SAFEARRAY에 지정된 시퀀스와 일치합니다. put_BootImageOptionsArray 및 put_BootImageOptions 모두 부팅 이미지를 지정하는 데 사용되며, 만든 디스크 이미지가 적용되기 전에 호출되는 후자의 함수입니다.

get_BootImageOptionsArray 및 get_BootImageOptions 함수는 put_BootImageOptionsArray 또는 put_BootImageOptions 마지막 호출의 결과를 검색합니다. 이러한 함수의 사용은 동기화되어야 합니다.

요구 사항

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

추가 정보

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray