Метод IPublishingWizard::Initialize (shobjidl.h)

Статья
08/26/2023

Инициализирует объект мастера публикации файлами для передачи, используемыми параметрами и типом создаваемого мастера.

Примечание Windows Vista больше не поддерживает мастер печати в Интернете. Однако этот метод по-прежнему можно использовать для создания мастера добавления сетевых мест.

Синтаксис

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

Параметры

[in] pdo

Тип: IDataObject*

Указатель на экземпляр IDataObject , представляющий файлы или папку для передачи, если pszServiceProvider имеет значение 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 может указывать на попытку инициализации неподдерживаемого мастера печати в Интернете путем передачи `InternetPhotoPrinting`pszServiceProvider. В Windows XP может указывать, что при инициализации мастера печати в Сети параметр pdo имеет значение NULL или указывает на пустое выделение.
E_NOTIMPL	Параметр pszServiceProvider не является одним из поддерживаемых значений или параметр dwOptions содержит неподдерживаемое сочетание флагов.

E_INVALIDARG

В Windows Vista может указывать на попытку инициализации неподдерживаемого мастера печати в Интернете путем передачи InternetPhotoPrintingpszServiceProvider.

В Windows XP может указывать, что при инициализации мастера печати в Сети параметр pdo имеет значение NULL или указывает на пустое выделение.

E_NOTIMPL

Параметр pszServiceProvider не является одним из поддерживаемых значений или параметр dwOptions содержит неподдерживаемое сочетание флагов.

/* 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
Header	shobjidl.h
DLL	Netplwiz.dll

Поделиться через