IShellLibrary::LoadLibraryFromKnownFolder 메서드(shobjidl_core.h)

아티클
03/02/2024

KNOWNFOLDERID에서 참조하는 라이브러리를 로드합니다.

구문

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

매개 변수

[in] kfidLibrary

형식: REFKNOWNFOLDERID

로드할 라이브러리를 식별하는 KNOWNFOLDERID 값입니다.

[in] grfMode

형식:DWORD

라이브러리 개체에 대한 액세스 및 공유 모드를 지정하는 하나 이상의 STGM 스토리지 중간 플래그입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드를 호출할 때 IShellLibrary 개체에 라이브러리가 포함된 경우 해당 라이브러리는 새 라이브러리를 사용하여 메모리에서 덮어씁니다.

이 라이브러리에 대한 기존 IShellLibrary 개체가 없는 경우 이 메서드 대신 SHLoadLibraryFromItem 을 호출할 수 있습니다.

예제

다음 코드 예제에서는 이 메서드를 래핑하는 도우미 함수 SHLoadLibraryFromKnownFolder를 보여 줍니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)