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

Artigo
03/02/2024

Obtém um item da área de trabalho usando sua URL de origem.

Sintaxe

HRESULT GetDesktopItemBySource(
  [in]      PCWSTR      pwszSource,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parâmetros

[in] pwszSource

Tipo: PCWSTR

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

[in, out] pcomp

Tipo: LPCOMPONENT

Um ponteiro para a estrutura COMPONENT que, quando esse método retorna com êxito, recebe os detalhes sobre o item da área de trabalho. Na entrada, o tamanho da estrutura deve ser definido.

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.

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

Compartilhar via