Função SHLoadLibraryFromParsingName (shobjidl_core.h)

Artigo
08/26/2023

Cria e carrega um objeto IShellLibrary para um caminho especificado.

Sintaxe

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[in] pszParsingName

Tipo: PCWSTR

O caminho para o qual carregar o objeto IShellLibrary .

[in] grfMode

Tipo: DWORD

Um ou mais sinalizadores de mídia 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

Uma referência ao IID da interface a ser recuperada por meio de ppv, normalmente IID_IShellLibrary.

[out] ppv

Tipo: void**

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IShellLibrary.

Valor retornado

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

Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação no riid que pode levar a resultados inesperados.

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

Requisitos


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)