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

Obtiene el elemento de escritorio especificado.

Sintaxis

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

Parámetros

nComponent

Tipo: int

Valor entero largo sin signo que contiene el índice del elemento de escritorio. Los valores de índice comienzan en cero. Use IActiveDesktop::GetDesktopItemCount para recuperar un recuento del número total de elementos de escritorio.

[in, out] pcomp

Tipo: LPCOMPONENT

Dirección de la estructura COMPONENT del elemento de escritorio recuperado.

dwReserved

Tipo: DWORD

Reservado. Debe establecerse en cero.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los valores de índice cambiarán a medida que se agreguen y quiten los elementos de escritorio de Active Desktop. Las aplicaciones no pueden suponer que un valor de índice siempre se asociará a un elemento de escritorio determinado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 4.71 o posterior)

Consulte también

IActiveDesktop