SHCreateItemFromParsingName, fonction (shobjidl_core.h)

Crée et initialise un objet d’élément Shell à partir d’un nom d’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 complet.

[in, optional] pbc

Type : IBindCtx*

Optional. 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 pouvez être transmis pour indiquer que les URL sont analysées à l’aide de la source de données du système de fichiers si possible. Construisez un objet de contexte de liaison à l’aide de CreateBindCtx et remplissez les valeurs à l’aide d’IBindCtx ::RegisterObjectParam. Consultez Lier des clés de chaîne de contexte pour obtenir la liste complète de ces clés. Consultez l’exemple d’analyse avec des paramètres pour obtenir un exemple d’utilisation de ce paramètre.

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 d’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 basé sur 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.

Spécifications