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

Obtiene el elemento de escritorio que coincide con la identificación especificada.

Sintaxis

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

Parámetros

dwID

Tipo: ULONG_PTR

Valor entero largo sin signo que contiene la identificación del elemento 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

La identificación del elemento de escritorio se devuelve en el miembro dwID de la estructura COMPONENT que se devuelve del método IActiveDesktop::GetDesktopItem . Esta identificación solo es válida hasta que se llama al método IActiveDesktop::ApplyChanges . Las aplicaciones que deben recuperar el mismo elemento de escritorio de forma coherente deben enumerar los elementos de escritorio mediante los métodos IActiveDesktop::GetDesktopItem e IActiveDesktop::GetDesktopItemCount .

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