Compartilhar via

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

  • Artigo

Adiciona o item da área de trabalho associado à URL especificada.

Sintaxe

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai da interface do usuário.

[in] pszSource

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres que contém a URL do item da área de trabalho.

[in] pcomp

Tipo: LPCOMPONENT

Um ponteiro para a estrutura COMPONENT que contém os detalhes do item da área de trabalho a ser adicionado.

dwFlags

Tipo: DWORD

Um valor inteiro longo sem sinal que controla esse método. Pode ser definido como ADDURL_SILENT para adicionar um item da área de trabalho sem exibir nenhuma interface do usuário.

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 uma instância do item da área de trabalho que já existe 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

Por padrão, esse método exibirá alguma interface do usuário e, em seguida, adicionará o item da área de trabalho à Área de Trabalho Ativa. Assim como IActiveDesktop::AddDesktopItem, o aplicativo cliente deve chamar IActiveDesktop::ApplyChanges para que as alterações sejam salvas no registro.

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