IWizardExtension::AddPages 메서드(shobjidl.h)

배열을 해당 페이지를 나타내는 PROPSHEETPAGE 구조체에 핸들로 채워서 마법사에 확장 페이지를 추가합니다.

구문

HRESULT AddPages(
  [out] HPROPSHEETPAGE *aPages,
  [in]  UINT           cPages,
  [out] UINT           *pnPagesAdded
);

매개 변수

[out] aPages

형식: HPROPSHEETPAGE*

마법사 대화 상자 페이지를 나타내는 PROPSHEETPAGE 핸들 배열에 대한 포인터입니다. 확장 페이지의 PROPSHEETPAGE 구조에 대한 핸들이 이 배열에 추가됩니다.

[in] cPages

형식: UINT

aPages의 요소 수입니다.

[out] pnPagesAdded

형식: UINT*

성공적으로 추가된 핸들 수입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

aPages가 가리키는 핸들의 배열에는 확장 페이지 앞과 다음 마법사 대화 상자에 대한 핸들이 포함될 수 있습니다. 배열의 포인터를 이 메서드에 전달하여 해당 값이 단순히 첫 번째 요소가 아닌 첫 번째 확장 페이지의 핸들을 수락할 준비가 된 첫 번째 빈 배열 요소가 되도록 해야 합니다. cPages에 전달된 값은 총 수 대신 사용되지 않는 배열 요소의 수를 명시해야 합니다.

예를 들어 hpages라는 배열에 두 개의 소개 호스트 페이지가 추가된 경우 IWizardExtension::AddPages 에 대한 호출은 다음과 같이 표시됩니다.

#define ARRAYSIZE(a)    (sizeof(a)/sizeof(a[0]))
g_iwe->AddPages(&hpages[2], ARRAYSIZE(hpages)-2, &nPages);

PROPSHEETPAGE 구조인 마법사 페이지를 호스트된 HTML 페이지와 혼동하지 마세요. 하나의 마법사 대화 상자 페이지에서는 여러 순차적 HTML 페이지를 호스트할 수 있습니다. 이 메서드는 마법사 확장에서 추가한 마법사 대화 상자 페이지의 수를 제공하며, 이 페이지에 표시되는 서버 쪽 HTML 페이지 수는 제공하지 않습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl.h
DLL	Shell32.dll