Método IPublishingWizard::Initialize (shobjidl.h)
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.
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 |
|---|---|
|
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. |
|
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 |