Método IShellLibrary::LoadLibraryFromKnownFolder (shobjidl_core.h)

Artigo
03/05/2024

Carrega a biblioteca referenciada por um KNOWNFOLDERID.

Sintaxe

HRESULT LoadLibraryFromKnownFolder(
  [in] REFKNOWNFOLDERID kfidLibrary,
  [in] DWORD            grfMode
);

Parâmetros

[in] kfidLibrary

Tipo: REFKNOWNFOLDERID

O valor KNOWNFOLDERID que identifica a biblioteca a ser carregada.

[in] grfMode

Tipo: DWORD

Um ou mais sinalizadores médios de armazenamento STGM que especificam modos de acesso e compartilhamento para o objeto de biblioteca.

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.

Comentários

Se o objeto IShellLibrary contiver uma biblioteca quando esse método for chamado, essa biblioteca será substituída na memória pela nova biblioteca.

Se não houver nenhum objeto IShellLibrary existente para essa biblioteca, SHLoadLibraryFromItem poderá ser chamado no lugar desse método.

Exemplos

O exemplo de código a seguir mostra a função auxiliar SHLoadLibraryFromKnownFolder, que encapsula esse método.

//
// from shobjidl.h
//
__inline HRESULT SHLoadLibraryFromKnownFolder(
    __in REFKNOWNFOLDERID kfidLibrary, 
    __in DWORD grfMode, 
    __in REFIID riid, 
    __deref_out void **ppv)
{
    *ppv = NULL;
    IShellLibrary *plib;
    HRESULT hr = CoCreateInstance( 
        CLSID_ShellLibrary,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_PPV_ARGS(&plib));
    if (SUCCEEDED(hr))
    {
        hr = plib->LoadLibraryFromKnownFolder(kfidLibrary, grfMode);
        if (SUCCEEDED(hr))
        {
            hr = plib->QueryInterface(riid, ppv);
        }
        plib->Release();
    }
    return hr;}

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)