SHCreateItemFromParsingName function (shobjidl_core.h)
Creates and initializes a Shell item object from a parsing name.
SHSTDAPI SHCreateItemFromParsingName( PCWSTR pszPath, IBindCtx *pbc, REFIID riid, void **ppv );
A pointer to a display name.
Optional. A pointer to a bind context used to pass parameters as inputs and outputs to the parsing function. These passed parameters are often specific to the data source and are documented by the data source owners. For example, the file system data source accepts the name being parsed (as a WIN32_FIND_DATA structure), using the STR_FILE_SYS_BIND_DATA bind context parameter.
STR_PARSE_PREFER_FOLDER_BROWSING can be passed to indicate that URLs are parsed using the file system data source when possible. Construct a bind context object using CreateBindCtx and populate the values using IBindCtx::RegisterObjectParam. See Bind Context String Keys for a complete list of these. See the Parsing With Parameters Sample for an example of the use of this parameter.
If no data is being passed to or received from the parsing function, this value can be NULL.
A reference to the IID of the interface to retrieve through ppv, typically IID_IShellItem or IID_IShellItem2.
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
We recommend that you use the IID_PPV_ARGS macro, defined in Objbase.h, to package the riid and ppv parameters. This macro provides the correct IID based on the interface pointed to by the value in ppv, which eliminates the possibility of a coding error in riid that could lead to unexpected results.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|