Compartir a través de

Función SHCreateItemFromParsingName (shobjidl_core.h)

  • Artículo

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

Sintaxis

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*

Opcional. 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 los documentan. Por ejemplo, el origen de datos del sistema de archivos acepta el nombre que se analiza (como una estructura de 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 Bind Context String Keys (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 pasa ni recibe ningún dato de la función de análisis, este valor puede ser NULL.

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: void**

Cuando este método se devuelve correctamente, contiene el puntero de interfaz solicitado en riid. Suele ser IShellItem o IShellItem2.

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 de ppv, lo que elimina la posibilidad de un error de codificación en riid que podría dar lugar a resultados inesperados.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shell32.dll