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

Artículo
03/13/2024

Carga la biblioteca a la que hace referencia un KNOWNFOLDERID.

Sintaxis

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

Parámetros

[in] kfidLibrary

Tipo: REFKNOWNFOLDERID

Valor KNOWNFOLDERID que identifica la biblioteca que se va a cargar.

[in] grfMode

Tipo: DWORD

Una o varias marcas de medios de almacenamiento STGM que especifican los modos de acceso y uso compartido para el objeto de biblioteca.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si el objeto IShellLibrary contiene una biblioteca cuando se llama a este método, esa biblioteca se sobrescribe en memoria con la nueva biblioteca.

Si no hay ningún objeto IShellLibrary existente para esta biblioteca, se puede llamar a SHLoadLibraryFromItem en lugar de este método.

Ejemplos

En el ejemplo de código siguiente se muestra la función auxiliar SHLoadLibraryFromKnownFolder, que encapsula este 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	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)