IShellLibrary::LoadLibraryFromKnownFolder-Methode (shobjidl_core.h)
Lädt die Bibliothek, auf die durch eine KNOWNFOLDERID verwiesen wird.
Syntax
HRESULT LoadLibraryFromKnownFolder(
[in] REFKNOWNFOLDERID kfidLibrary,
[in] DWORD grfMode
);
Parameter
[in] kfidLibrary
Typ: REFKNOWNFOLDERID
Der KNOWNFOLDERID-Wert , der die zu ladende Bibliothek identifiziert.
[in] grfMode
Art: DWORD
Mindestens ein STGM-Speichermediumflags , das Zugriffs- und Freigabemodi für das Bibliotheksobjekt angibt.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn das IShellLibrary-Objekt beim Aufrufen dieser Methode eine Bibliothek enthält, wird diese Bibliothek im Arbeitsspeicher mit der neuen Bibliothek überschrieben.
Wenn kein IShellLibrary-Objekt für diese Bibliothek vorhanden ist, kann SHLoadLibraryFromItem anstelle dieser Methode aufgerufen werden.
Beispiele
Das folgende Codebeispiel zeigt die Hilfsfunktion SHLoadLibraryFromKnownFolder, die diese Methode umschließt.
//
// 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;}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |