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

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

Confira também

Ishelllibrary

IShellLibrary::LoadLibraryFromItem

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder

SHLoadLibraryFromParsingName

Bibliotecas do Windows