Функция SHCreateItemFromParsingName (shobjidl_core.h)

Создает и инициализирует объект элемента оболочки из имени синтаксического анализа.

Синтаксис

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

Параметры

[in] pszPath

Тип: PCWSTR

Указатель на отображаемое имя.

[in, optional] pbc

Тип: IBindCtx*

Необязательно. Указатель на контекст привязки, используемый для передачи параметров в качестве входных и выходных данных функции синтаксического анализа. Эти переданные параметры часто относятся к источнику данных и документируются владельцами источников данных. Например, источник данных файловой системы принимает анализируемое имя (как структуру WIN32_FIND_DATA ), используя параметр контекста привязки STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING можно передать, чтобы указать, что URL-адреса анализируются с помощью источника данных файловой системы, когда это возможно. Создайте объект контекста привязки с помощью CreateBindCtx и заполните значения с помощью IBindCtx::RegisterObjectParam. Полный список этих ключей см. в разделе "Привязка строковых ключей контекста". Пример использования этого параметра см. в примере анализа параметров .

Если данные не передаются или не передаются из функции синтаксического анализа, это значение может иметь значение NULL.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_IShellItem или IID_IShellItem2.

[out] ppv

Тип: void**

Когда этот метод возвращается успешно, содержит указатель интерфейса, запрошенный в riid. Обычно это IShellItem или IShellItem2.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Замечания

Рекомендуется использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный идентификатор IID на основе интерфейса, на который указывает значение в PPV, что устраняет возможность ошибки кодирования в riid , которая может привести к непредвиденным результатам.

Требования