Compartilhar via

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

  • Artigo

Obtém o item da área de trabalho que corresponde à identificação fornecida.

Sintaxe

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parâmetros

dwID

Tipo: ULONG_PTR

Um valor inteiro longo sem sinal que contém a identificação do item da área de trabalho.

[in, out] pcomp

Tipo: LPCOMPONENT

O endereço da estrutura COMPONENT do item de área de trabalho recuperado.

dwReserved

Tipo: DWORD

Reservado. Deve ser definido como zero.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A identificação do item da área de trabalho é retornada no membro dwID da estrutura COMPONENT retornada do método IActiveDesktop::GetDesktopItem . Essa identificação só é válida até que o método IActiveDesktop::ApplyChanges seja chamado. Os aplicativos que devem recuperar o mesmo item da área de trabalho de forma consistente devem enumerar os itens da área de trabalho usando os métodos IActiveDesktop::GetDesktopItem e IActiveDesktop::GetDesktopItemCount .

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