Função SHLoadLibraryFromKnownFolder (shobjidl_core.h)
Cria e carrega um objeto IShellLibrary para uma ID de pasta conhecida especificada.
Sintaxe
HRESULT SHLoadLibraryFromKnownFolder(
[in] REFKNOWNFOLDERID kfidLibrary,
[in] DWORD grfMode,
[in] REFIID riid,
[out] void **ppv
);
Parâmetros
[in] kfidLibrary
Tipo: REFKNOWNFOLDERID
O valor KNOWNFOLDERID que identifica a pasta conhecida a ser carregada no objeto IShellLibrary .
[in] grfMode
Tipo: DWORD
Um ou mais sinalizadores médios de armazenamento que especificam modos de acesso e compartilhamento para o objeto de biblioteca. Sinalizadores normalmente especificados são STGM_READ ou STGM_READWRITE. Para obter mais informações, consulte STGM.
[in] riid
Tipo: REFIID
O IID para IShellLibrary. (Consulte Comentários para obter mais informações.)
[out] ppv
Tipo: void**
Quando essa função retorna com êxito, recebe o objeto IShellLibrary carregado. (Consulte Comentários para obter mais informações.)
Retornar valor
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Essa é uma função auxiliar embutida que encapsula o método IShellLibrary::LoadLibraryFromKnownFolder .
Uso
A macro IID_PPV_ARGS geralmente é usada para gerar os parâmetros riid e ppv para essa função. Para obter um exemplo, consulte SHCreateLibrary.Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |
Confira também
IShellLibrary::LoadLibraryFromItem