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

Obtém o item da área de trabalho especificado.

Sintaxe

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parâmetros

nComponent

Tipo: int

Um valor inteiro longo sem sinal que contém o índice do item da área de trabalho. Os valores de índice começam em zero. Use IActiveDesktop::GetDesktopItemCount para recuperar uma contagem do número total de itens 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

Os valores de índice serão alterados à medida que os itens da área de trabalho forem adicionados e removidos da Área de Trabalho Ativa. Os aplicativos não podem assumir que um valor de índice sempre será associado a um item de área de trabalho específico.

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