Função SHLoadLibraryFromKnownFolder (shobjidl_core.h)

Artigo
03/02/2024

Cria e carrega um objeto IShellLibrary para uma ID de pasta conhecida especificada.

Sintaxe

HRESULT SHLoadLibraryFromKnownFolder(
  [in]  REFKNOWNFOLDERID kfidLibrary,
  [in]  DWORD            grfMode,
  [in]  REFIID           riid,
  [out] void             **ppv
);

Parâmetros

[in] kfidLibrary

Tipo: REFKNOWNFOLDERID

O valor KNOWNFOLDERID que identifica a pasta conhecida a ser carregada no objeto IShellLibrary .

[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 para obter mais informações.)

[out] ppv

Tipo: void**

Quando essa função retorna com êxito, recebe o objeto IShellLibrary carregado. (Consulte Comentários para obter mais informações.)

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

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

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.

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)