Función SHCreateItemFromParsingName (shobjidl_core.h)

Crea e inicializa un objeto de elemento de Shell a partir de un nombre de análisis.

Syntax

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

Parámetros

[in] pszPath

Tipo: PCWSTR

Puntero a un nombre para mostrar.

[in, optional] pbc

Tipo: IBindCtx*

Optional. Puntero a un contexto de enlace usado para pasar parámetros como entradas y salidas a la función de análisis. Estos parámetros pasados suelen ser específicos del origen de datos y los propietarios del origen de datos documentan. Por ejemplo, el origen de datos del sistema de archivos acepta el nombre que se analiza (como una estructura WIN32_FIND_DATA ), mediante el parámetro de contexto de enlace de STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING se puede pasar para indicar que las direcciones URL se analizan mediante el origen de datos del sistema de archivos siempre que sea posible. Construya un objeto de contexto de enlace mediante CreateBindCtx y rellene los valores mediante IBindCtx::RegisterObjectParam. Consulte Enlazar claves de cadena de contexto para obtener una lista completa de estos. Consulte el Ejemplo de análisis con parámetros para obtener un ejemplo del uso de este parámetro.

Si no se pasan datos a la función de análisis o se reciben de ellos, este valor puede ser NULL.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz para recuperar a través de ppv, normalmente IID_IShellItem o IID_IShellItem2.

[out] ppv

Tipo: void**

Cuando este método vuelve correctamente, contiene el puntero de interfaz solicitado en riid. Normalmente es IShellItem o IShellItem2.

Valor devuelto

Tipo: HRESULT

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

Observaciones

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.

Requisitos