Função SHLoadLibraryFromItem (shobjidl_core.h)

Artigo
03/02/2024

Cria e carrega um objeto IShellLibrary de um arquivo de definição de biblioteca especificado.

Sintaxe

HRESULT SHLoadLibraryFromItem(
  [in]  IShellItem *psiLibrary,
  [in]  DWORD      grfMode,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Parâmetros

[in] psiLibrary

Tipo: IShellItem*

Um objeto IShellItem para o arquivo de definição de biblioteca a ser carregado.

[in] grfMode

Tipo: DWORD

Um ou mais sinalizadores médios de armazenamento que especificam modos de acesso e compartilhamento para o objeto de biblioteca. Sinalizadores normalmente especificados são STGM_READ ou STGM_READWRITE. Para obter mais informações, consulte STGM.

[in] riid

Tipo: REFIID

O IID para IShellLibrary. (Consulte comentários de uso.)

[out] ppv

Tipo: void**

Recebe o objeto IShellLibrary carregado. (Consulte comentários de uso.)

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Uso

A macro IID_PPV_ARGS geralmente é usada para gerar os parâmetros riid e ppv para essa função. Para obter um exemplo, consulte SHCreateLibrary.

Essa é uma função auxiliar embutida que encapsula o método IShellLibrary::LoadLibraryFromItem .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)