Compartir a través de

Método IPublishingWizard::Initialize (shobjidl.h)

  • Artículo

Inicializa el objeto Asistente para publicación con los archivos que se van a transferir, la configuración que se va a usar y el tipo de asistente que se va a crear.

Nota Windows Vista ya no admite el Asistente para impresión en línea. Sin embargo, este método todavía se puede usar para generar el Asistente para agregar lugar de red.
 

Sintaxis

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

Parámetros

[in] pdo

Tipo: IDataObject*

Puntero a una instancia de IDataObject que representa los archivos o carpetas que se van a transferir, si pszServiceProvider es InternetPhotoPrinting. Si pszServiceProvider es AddNetPlace, este parámetro es NULL.

[in] dwOptions

Tipo: DWORD

Combinación de las marcas siguientes.

SHPWHF_NORECOMPRESS

No permita la recompresión de los datos de imagen. Para su uso con el Asistente para impresión en línea.

SHPWHF_NONETPLACECREATE

No cree un acceso directo de lugar de red cuando se complete la transferencia de datos. Esta marca se usa con el Asistente para agregar lugar de red.

SHPWHF_NOFILESELECTOR

No permita al usuario cambiar la selección de archivos en el asistente.

SHPWHF_USEMRU

No compatible.

SHPWHF_ANYLOCATION

Windows Vista y versiones posteriores. Para su uso con el Asistente para agregar lugar de red. Si se establece esta marca y pszServiceProvider es AddNetPlace, el Asistente para agregar lugar de red muestra una opción para seleccionar una ubicación de red distinta de las ubicaciones o proveedores registrados para que aparezcan en el asistente.

SHPWHF_VALIDATEVIAWEBFOLDERS

Para su uso con el Asistente para agregar lugar de red. En Windows XP, si se establece esta marca y se produce un error al intentar abrir la ubicación de red mediante WebDAV, el Asistente para agregar lugar de red intenta crear una carpeta web para la ubicación, con compatibilidad con WEC. En Windows Vista y Windows Server 2003, esta marca no tiene ningún efecto y es posible que las ubicaciones de red sin compatibilidad con WebDAV no se abran como carpetas web.

[in] pszServiceScope

Tipo: LPCWSTR

Cadena Unicode que indica el tipo de asistente que se va a mostrar. En Windows Vista se admiten los siguientes valores que distinguen mayúsculas de minúsculas.

AddNetPlace

Inicialice el Asistente para agregar lugar de red.

InternetPhotoPrinting

Inicialice el Asistente para impresión en línea. No se admite en Windows Vista.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario, incluido lo siguiente:

Código devuelto Descripción
E_INVALIDARG
 En Windows Vista, puede indicar un intento de inicializar el Asistente para impresión en línea no compatible pasando InternetPhotoPrintingpszServiceProvider.

En Windows XP, puede indicar que al inicializar el Asistente para impresión en línea, el parámetro pdo es NULL o apunta a una selección vacía.
E_NOTIMPL
 El parámetro pszServiceProvider no es uno de los valores admitidos o el parámetro dwOptions contiene una combinación no admitida de marcas.

Comentarios

Se llama a IPublishingWizard::Initialize, implementado por un objeto del Asistente para publicación, para inicializar el objeto del asistente.

El ejemplo siguiente no funciona en Windows Vista porque no se puede crear una instancia del Asistente para impresión en línea a través de IPublishingWizard en 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 no muestra realmente el asistente inicializado. Consulte el tema IPublishingWizard para obtener información sobre cómo mostrar el asistente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl.h
Archivo DLL Netplwiz.dll