Función SHLoadLibraryFromParsingName (shobjidl_core.h)

Artículo
08/26/2023

Crea y carga un objeto IShellLibrary para una ruta de acceso especificada.

Sintaxis

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parámetros

[in] pszParsingName

Tipo: PCWSTR

Ruta de acceso para la que se va a cargar el objeto IShellLibrary .

[in] grfMode

Tipo: DWORD

Una o varias marcas de medios de almacenamiento que especifican los modos de acceso y uso compartido para el objeto de biblioteca. Las marcas especificadas normalmente son STGM_READ o STGM_READWRITE. Para obtener más información, vea STGM.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que se va a recuperar a través de ppv, normalmente IID_IShellLibrary.

[out] ppv

Tipo: void**

Cuando este método devuelve correctamente, contiene el puntero de interfaz solicitado en riid. Esto suele ser IShellLibrary.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación en riid que podría dar lugar a resultados inesperados.

Se trata de una función auxiliar insertada que encapsula el método IShellLibrary::LoadLibraryFromItem .

Requisitos


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)