IPublishingWizard::Initialize 메서드(shobjidl.h)

아티클
08/26/2023

전송할 파일, 사용할 설정 및 만들 마법사 유형을 사용하여 게시 마법사 개체를 초기화합니다.

참고 Windows Vista는 더 이상 온라인 인쇄 마법사를 지원하지 않습니다. 그러나 이 메서드를 사용하여 네트워크 위치 추가 마법사를 생성할 수 있습니다.

구문

HRESULT Initialize(
  [in] IDataObject *pdo,
  [in] DWORD       dwOptions,
  [in] LPCWSTR     pszServiceScope
);

매개 변수

[in] pdo

형식: IDataObject*

pszServiceProvider가 인 경우 전송할 파일 또는 폴더를 나타내는 IDataObject의 instance 대한 포인터입니다InternetPhotoPrinting. pszServiceProvider가 이AddNetPlace면 이 매개 변수는 NULL입니다.

[in] dwOptions

형식:DWORD

다음 플래그의 조합입니다.

SHPWHF_NORECOMPRESS

이미지 데이터의 압축을 다시압축할 수 없습니다. 온라인 인쇄 마법사에서 사용할 수 있습니다.

SHPWHF_NONETPLACECREATE

데이터 전송이 완료되면 네트워크 위치 바로 가기를 만들지 마세요. 이 플래그는 네트워크 위치 추가 마법사에서 사용할 수 있습니다.

SHPWHF_NOFILESELECTOR

사용자가 마법사 내에서 파일 선택을 변경할 수 없도록 합니다.

SHPWHF_USEMRU

지원되지 않습니다.

SHPWHF_ANYLOCATION

Windows Vista 이상. 네트워크 위치 추가 마법사와 함께 사용할 수 있습니다. 이 플래그가 설정되고 pszServiceProvider 가 AddNetPlace인 경우 네트워크 위치 추가 마법사에는 마법사에 표시되도록 등록된 위치 또는 공급자 이외의 네트워크 위치를 선택하는 옵션이 표시됩니다.

SHPWHF_VALIDATEVIAWEBFOLDERS

네트워크 위치 추가 마법사와 함께 사용할 수 있습니다. Windows XP에서 이 플래그가 설정되고 WebDAV를 사용하여 네트워크 위치를 열려는 시도가 실패하면 네트워크 위치 추가 마법사는 WEC 지원을 사용하여 위치에 대한 웹 폴더를 만들려고 시도합니다. Windows Vista 및 Windows Server 2003에서는 이 플래그가 적용되지 않으며 WebDAV를 지원하지 않는 네트워크 위치는 웹 폴더로 열리지 않을 수 있습니다.

[in] pszServiceScope

형식: LPCWSTR

표시할 마법사의 유형을 나타내는 유니코드 문자열입니다. Windows Vista에서 지원되는 대/소문자 구분 값은 다음과 같습니다.

AddNetPlace

네트워크 위치 추가 마법사를 초기화합니다.

InternetPhotoPrinting

온라인 인쇄 마법사를 초기화합니다. Windows Vista에서는 지원되지 않습니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 오류 값을 반환합니다.

반환 코드	설명
E_INVALIDARG	Windows Vista에서 는 pszServiceProvider를 전달 `InternetPhotoPrinting` 하여 지원되지 않는 온라인 인쇄 마법사를 초기화하려는 시도를 나타낼 수 있습니다. Windows XP에서 은 온라인 인쇄 마법사를 초기화할 때 pdo 매개 변수가 NULL 이거나 빈 선택 영역을 가리킨다는 것을 나타낼 수 있습니다.
E_NOTIMPL	pszServiceProvider 매개 변수는 지원되는 값 중 하나가 아니거나 dwOptions 매개 변수에 지원되지 않는 플래그 조합이 포함되어 있습니다.

설명

게시 마법사 개체에 의해 구현된 IPublishingWizard::Initialize는 마법사 개체를 초기화하기 위해 호출됩니다.

다음 샘플은 Windows Vista에서 IPublishingWizard 를 통해 온라인 인쇄 마법사를 인스턴스화할 수 없으므로 Windows Vista에서 작동하지 않습니다.

/* initializing the Online Print Wizard in Windows XP or Windows 2003 Server*/
hr = pPublish->Initialize(pDataObject,  // A data object that represents files or 
                                        // folders to transfer.
                          SHPWHF_NOFILESELECTOR,     // Flags
                          L"InternetPhotoPrinting"); // Display the Online Print Wizard.

IPublishingWizard::Initialize 는 실제로 초기화된 마법사를 표시하지 않습니다. 마법사를 표시하는 방법에 대한 자세한 내용은 IPublishingWizard 항목을 참조하세요.

요구 사항

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

다음을 통해 공유