Fonction SHCreateItemFromParsingName (shobjidl_core.h)

Article
08/26/2023

Crée et initialise un objet élément d’interpréteur de commandes à partir d’un nom de l’analyse.

Syntaxe

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

Paramètres

[in] pszPath

Type : PCWSTR

Pointeur vers un nom d’affichage.

[in, optional] pbc

Type : IBindCtx*

facultatif. Pointeur vers un contexte de liaison utilisé pour passer des paramètres en tant qu’entrées et sorties à la fonction d’analyse. Ces paramètres passés sont souvent spécifiques à la source de données et sont documentés par les propriétaires de la source de données. Par exemple, la source de données du système de fichiers accepte le nom analysé (en tant que structure WIN32_FIND_DATA ), à l’aide du paramètre de contexte de liaison STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING peut être passé pour indiquer que les URL sont analysées à l’aide de la source de données du système de fichiers dans la cas où cela est possible. Construisez un objet de contexte de liaison à l’aide de CreateBindCtx et renseignez les valeurs à l’aide de IBindCtx::RegisterObjectParam. Pour obtenir la liste complète de ces clés , consultez Lier des clés de chaîne de contexte. Pour obtenir un exemple d’utilisation de ce paramètre, consultez l’exemple d’analyse avec des paramètres .

Si aucune donnée n’est transmise ou reçue à partir de la fonction d’analyse, cette valeur peut être NULL.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IShellItem ou IID_IShellItem2.

[out] ppv

Type : void**

Lorsque cette méthode retourne correctement, contient le pointeur d’interface demandé dans riid. Il s’agit généralement de IShellItem ou IShellItem2.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage dans riid qui pourrait entraîner des résultats inattendus.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll

Share via