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*
省略可能。 パラメーターを入力として渡し、解析関数に出力するために使用されるバインド コンテキストへのポインター。 これらの渡されたパラメーターは、多くの場合、データ ソースに固有であり、データ ソースの所有者によって文書化されます。 たとえば、ファイル システム データ ソースは、STR_FILE_SYS_BIND_DATA バインド コンテキスト パラメーターを使用して、解析される名前を (WIN32_FIND_DATA構造体として) 受け入れます。
STR_PARSE_PREFER_FOLDER_BROWSING を渡して、可能な場合はファイル システム データ ソースを使用して URL が解析されることを示すことができます。 CreateBindCtx を使用してバインド コンテキスト オブジェクトを構築し、IBindCtx::RegisterObjectParam を使用して値を設定します。 これらの完全な一覧については、「 バインド コンテキスト文字列キー 」を参照してください。 このパラメーターの使用例については、「 パラメーターによる解析のサンプル 」を参照してください。
解析関数にデータが渡されないか、解析関数から受け取られるデータがない場合、この値は NULL にすることができます。
[in] riid
型: REFIID
ppv を介して取得するインターフェイスの IID への参照 (通常はIID_IShellItemまたはIID_IShellItem2)。
[out] ppv
型: void**
このメソッドが正常に返されると、 riid で要求されたインターフェイス ポインターが含まれます。 これは通常、 IShellItem または IShellItem2 です。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
解説
riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
[DLL] | Shell32.dll |