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

  • Artigo

Inicializa o objeto Assistente de Publicação com os arquivos a serem transferidos, as configurações a serem usadas e o tipo de assistente a ser criado.

Nota O Windows Vista não dá mais suporte ao Assistente de Impressão Online. No entanto, esse método ainda pode ser usado para gerar o Assistente para Adicionar Local de Rede.
 

Sintaxe

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

Parâmetros

[in] pdo

Tipo: IDataObject*

Um ponteiro para uma instância de IDataObject que representa os arquivos ou pasta a serem transferidos, se pszServiceProvider for InternetPhotoPrinting. Se pszServiceProvider for AddNetPlace, esse parâmetro será NULL.

[in] dwOptions

Tipo: DWORD

Uma combinação dos sinalizadores a seguir.

SHPWHF_NORECOMPRESS

Não permita recompactação de dados de imagem. Para uso com o Assistente de Impressão Online.

SHPWHF_NONETPLACECREATE

Não crie um atalho de local de rede quando a transferência de dados for concluída. Esse sinalizador é usado com o Assistente para Adicionar Local de Rede.

SHPWHF_NOFILESELECTOR

Não permita que o usuário altere a seleção de arquivo no assistente.

SHPWHF_USEMRU

Não há suporte.

SHPWHF_ANYLOCATION

Windows Vista e posteriores. Para uso com o Assistente para Adicionar Local de Rede. Se esse sinalizador estiver definido e pszServiceProvider for AddNetPlace, o assistente Adicionar Local de Rede mostrará uma opção para selecionar um local de rede diferente dos locais ou provedores registrados para aparecer no assistente.

SHPWHF_VALIDATEVIAWEBFOLDERS

Para uso com o Assistente para Adicionar Local de Rede. No Windows XP, se esse sinalizador estiver definido e uma tentativa de abrir o local de rede usando WebDAV falhar, o Assistente para Adicionar Local de Rede tentará criar uma pasta da Web para o local, usando o suporte para WEC. No Windows Vista e no Windows Server 2003, esse sinalizador não tem efeito e os locais de rede sem suporte para WebDAV podem não ser abertos como pastas da Web.

[in] pszServiceScope

Tipo: LPCWSTR

Cadeia de caracteres Unicode que indica o tipo de assistente a ser exibido. Os valores que diferenciam maiúsculas de minúsculas a seguir têm suporte no Windows Vista.

AddNetPlace

Inicialize o Assistente para Adicionar Local de Rede.

InternetPhotoPrinting

Inicialize o Assistente de Impressão Online. Sem suporte no Windows Vista.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, incluindo o seguinte:

Código de retorno Descrição
E_INVALIDARG
 No Windows Vista, pode indicar uma tentativa de inicializar o Assistente de Impressão Online sem suporte passando InternetPhotoPrintingpszServiceProvider.

No Windows XP, pode indicar que, ao inicializar o Assistente de Impressão Online, o parâmetro pdo é NULL ou aponta para uma seleção vazia.
E_NOTIMPL
 O parâmetro pszServiceProvider não é um dos valores com suporte ou o parâmetro dwOptions contém uma combinação sem suporte de sinalizadores.

Comentários

IPublishingWizard::Initialize, implementado por um objeto do Assistente de Publicação , é chamado para inicializar o objeto do assistente.

O exemplo a seguir não funciona no Windows Vista porque o Assistente de Impressão Online não pode ser instanciado por meio do IPublishingWizard no 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 não exibe o assistente inicializado. Consulte o tópico IPublishingWizard para obter informações sobre como exibir o assistente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl.h
DLL Netplwiz.dll