Metodo IShellLibrary::LoadLibraryFromKnownFolder (shobjidl_core.h)

Carica la libreria a cui fa riferimento un OGGETTO KNOWNFOLDERID.

Sintassi

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

Parametri

[in] kfidLibrary

Tipo: REFKNOWNFOLDERID

Valore KNOWNFOLDERID che identifica la libreria da caricare.

[in] grfMode

Tipo: DWORD

Uno o più flag di archiviazione STGM che specificano le modalità di accesso e condivisione per l'oggetto libreria.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se l'oggetto IShellLibrary contiene una libreria quando viene chiamato questo metodo, tale libreria viene sovrascritta in memoria con la nuova libreria.

Se non esiste alcun oggetto IShellLibrary esistente per questa libreria, è possibile chiamare SHLoadLibraryFromItem al posto di questo metodo.

Esempio

Nell'esempio di codice seguente viene illustrata la funzione helper SHLoadLibraryFromKnownFolder, che esegue il wrapping di questo metodo.

//
// 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;}

Requisiti

Vedi anche

IShellLibrary

IShellLibrary::LoadLibraryFromItem

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder

SHLoadLibraryFromParsingName

Librerie di Windows