Compartilhar via

Método IActiveDesktop::AddDesktopItemWithUI (shlobj_core.h)

  • Artigo

Adiciona um item de área de trabalho à Área de Trabalho Ativa depois de exibir interfaces do usuário que confirmam a adição do item da área de trabalho, verificando permissões de zona de segurança e perguntando se o usuário deseja criar uma assinatura.

Sintaxe

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

Parâmetros

[in, optional] hwnd

Digite: HWND

O identificador da janela pai. Se NULL, o item da área de trabalho será adicionado sem exibir nenhuma interface do usuário, de acordo com as permissões de zona de segurança correspondentes. Para obter mais informações, consulte Sobre zonas de segurança de URL.

[in] pcomp

Tipo: LPCOMPONENT

Endereço da estrutura COMPONENT que contém os detalhes do item da área de trabalho a ser adicionado.

dwReserved

Tipo: DWORD

Valor inteiro longo sem sinal que contém os sinalizadores que controlam como o item da área de trabalho é adicionado. Pode ser um dos valores a seguir.

DTI_ADDUI_DEFAULT

Faça a ação padrão. Idêntico ao uso de zero.

DTI_ADDUI_DISPSUBWIZARD

Ative o assistente de assinatura para permitir que o usuário assine este item da área de trabalho.

DTI_ADDUI_POSITIONITEM

Instrua o sistema a examinar a estrutura COMPPOS passada para o membro cpPos da estrutura COMPONENT para garantir que os valores estejam dentro de limites razoáveis. Esse valor foi adicionado para a Internet Explorer 5.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
E_FAIL
 Falha ao adicionar o item da área de trabalho ou já existe uma instância do item da área de trabalho na Área de Trabalho Ativa.
E_INVAILDARG
 Um ou mais dos parâmetros eram inválidos.
S_OK
 Se o sinalizador ADDURL_SILENT tiver sido definido, o item da área de trabalho foi adicionado com êxito ou já existe na Área de Trabalho Ativa. Caso contrário, o item da área de trabalho foi adicionado com êxito.

Comentários

Esse método cria uma segunda instância da Área de Trabalho Ativa para adicionar o item da área de trabalho, para que o item da área de trabalho não apareça na instância atual. O aplicativo deve chamar o método IUnknown::Release nessa interface IActiveDesktop e, em seguida, usar a função CoCreateInstance para recuperar o objeto Active Desktop com o componente recém-adicionado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
DLL Shell32.dll (versão 4.71 ou posterior)

Confira também

IActiveDesktop

Usando o objeto Da Área de Trabalho Ativa