由 ShellExecuteEx 打开时 Windows 文件属性对话框中缺少数据
Missing data in Windows file properties dialog when opened by ShellExecuteEx
我想显示来自我的 C++ 代码的文件的 Windows 文件属性对话框(在 Windows 7 上,使用 VS 2012)。我找到了下面的代码 (which also contains a full MCVE). I also tried calling CoInitializeEx()
first, as mentioned in the documentation of ShellExecuteEx()
:
// Whether I initialize COM or not doesn't seem to make a difference.
CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);
SHELLEXECUTEINFO info = {0};
info.cbSize = sizeof info;
info.lpFile = L"D:\Test.txt";
info.nShow = SW_SHOW;
info.fMask = SEE_MASK_INVOKEIDLIST;
info.lpVerb = L"properties";
ShellExecuteEx(&info);
此代码有效,即显示属性对话框并且 ShellExecuteEx()
returns TRUE
。但是,在 详细信息 选项卡中,大小 属性 错误并且缺少日期属性:
详细信息 选项卡中的其余属性(例如文件属性)是正确的。奇怪的是,大小和日期属性在 常规 选项卡(最左侧的选项卡)中正确显示。
如果我通过 Windows 资源管理器(文件 → 右键单击 → 属性)打开属性 window,那么 详细信息 选项卡中的所有属性正确显示:
我在不同的驱动器和三台不同的 PC(1x 德语 64 位 Windows 7、1x 英语 64 位 Windows7, 1x 英文 32 位 Windows7).我总是得到相同的结果,即使我 运行 我的程序作为管理员。不过,在(64 位)Windows 8.1 上,代码对我有用。
我发现问题的原始程序是一个 MFC 应用程序,但如果我将以上代码放入控制台应用程序,我会看到同样的问题。
我需要做什么才能在 Windows 7 的 详细信息 选项卡中显示正确的值?有可能吗?
正如 Raymond Chen 所建议的那样,将路径替换为 PIDL (SHELLEXECUTEINFO::lpIDList
) 可使属性对话框在通过 Windows 7 调用时正确显示大小和日期字段15=].
似乎 ShellExecuteEx()
的 Windows 7 实现有问题,因为较新版本的 OS 与 SHELLEXCUTEINFO::lpFile
没有问题。
还有另一种可能的解决方案,涉及创建 IContextMenu
的实例并调用 IContextMenu::InvokeCommand()
方法。我想这就是 ShellExecuteEx()
在幕后所做的事情。向下滚动到 解决方案 2 以获取示例代码。
解决方案 1 - 使用 PIDL 和 ShellExecuteEx
#include <atlcom.h> // CComHeapPtr
#include <shlobj.h> // SHParseDisplayName()
#include <shellapi.h> // ShellExecuteEx()
// CComHeapPtr is a smart pointer that automatically calls CoTaskMemFree() when
// the current scope ends.
CComHeapPtr<ITEMIDLIST> pidl;
SFGAOF sfgao = 0;
// Convert the path into a PIDL.
HRESULT hr = ::SHParseDisplayName( L"D:\Test.txt", nullptr, &pidl, 0, &sfgao );
if( SUCCEEDED( hr ) )
{
// Show the properties dialog of the file.
SHELLEXECUTEINFO info{ sizeof(info) };
info.hwnd = GetSafeHwnd();
info.nShow = SW_SHOWNORMAL;
info.fMask = SEE_MASK_INVOKEIDLIST;
info.lpIDList = pidl;
info.lpVerb = L"properties";
if( ! ::ShellExecuteEx( &info ) )
{
// Make sure you don't put ANY code before the call to ::GetLastError()
// otherwise the last error value might be invalidated!
DWORD err = ::GetLastError();
// TODO: Do your error handling here.
}
}
else
{
// TODO: Do your error handling here
}
当从一个简单的基于对话框的 MFC 应用程序的按钮单击处理程序调用时,此代码在 Win 7 和 Win 10(其他未测试的版本)下对我都有效。
如果您将 info.hwnd
设置为 NULL
,它也适用于控制台应用程序(只需从示例代码中删除行 info.hwnd = GetSafeHwnd();
,因为它已经用 0 初始化)。在 SHELLEXECUTEINFO 参考中指出 hwnd
成员是可选的。
不要忘记在应用程序启动时强制调用 CoInitialize()
或 CoInitializeEx()
并在关闭时强制调用 CoUninitialize()
以正确初始化和取消初始化 COM。
备注:
CComHeapPtr
is a smart pointer included in ATL that automatically calls CoTaskMemFree()
when the scope ends. It's an ownership-transferring pointer with semantics similar to the deprecated std::auto_ptr
。也就是说,当你将一个CComHeapPtr
对象赋值给另一个对象,或者使用带有CComHeapPtr
参数的构造函数时,原来的对象将变成一个NULL指针。
CComHeapPtr<ITEMIDLIST> pidl2( pidl1 ); // pidl1 allocated somewhere before
// Now pidl1 can't be used anymore to access the ITEMIDLIST object.
// It has transferred ownership to pidl2!
我仍在使用它,因为它开箱即用,可以与 COM APIs 一起使用。
解决方案 2 - 使用 IContextMenu
以下代码需要 Windows Vista 或更新版本,因为我使用的是 "modern" IShellItem
API.
我将代码包装到函数 ShowPropertiesDialog()
中,该函数采用 window 句柄和文件系统路径。如果发生任何错误,该函数将抛出 std::system_error
异常。
#include <atlcom.h>
#include <string>
#include <system_error>
/// Show the shell properties dialog for the given filesystem object.
/// \exception Throws std::system_error in case of any error.
void ShowPropertiesDialog( HWND hwnd, const std::wstring& path )
{
using std::system_error;
using std::system_category;
if( path.empty() )
throw system_error( std::make_error_code( std::errc::invalid_argument ),
"Invalid empty path" );
// SHCreateItemFromParsingName() returns only a generic error (E_FAIL) if
// the path is incorrect. We can do better:
if( ::GetFileAttributesW( path.c_str() ) == INVALID_FILE_ATTRIBUTES )
{
// Make sure you don't put ANY code before the call to ::GetLastError()
// otherwise the last error value might be invalidated!
DWORD err = ::GetLastError();
throw system_error( static_cast<int>( err ), system_category(), "Invalid path" );
}
// Create an IShellItem from the path.
// IShellItem basically is a wrapper for an IShellFolder and a child PIDL, simplifying many tasks.
CComPtr<IShellItem> pItem;
HRESULT hr = ::SHCreateItemFromParsingName( path.c_str(), nullptr, IID_PPV_ARGS( &pItem ) );
if( FAILED( hr ) )
throw system_error( hr, system_category(), "Could not get IShellItem object" );
// Bind to the IContextMenu of the item.
CComPtr<IContextMenu> pContextMenu;
hr = pItem->BindToHandler( nullptr, BHID_SFUIObject, IID_PPV_ARGS( &pContextMenu ) );
if( FAILED( hr ) )
throw system_error( hr, system_category(), "Could not get IContextMenu object" );
// Finally invoke the "properties" verb of the context menu.
CMINVOKECOMMANDINFO cmd{ sizeof(cmd) };
cmd.lpVerb = "properties";
cmd.hwnd = hwnd;
cmd.nShow = SW_SHOWNORMAL;
hr = pContextMenu->InvokeCommand( &cmd );
if( FAILED( hr ) )
throw system_error( hr, system_category(),
"Could not invoke the \"properties\" verb from the context menu" );
}
在下文中,我展示了如何使用来自 CDialog 派生的 class 的按钮处理程序的 ShowPropertiesDialog()
的示例。实际上 ShowPropertiesDialog()
是独立于 MFC 的,因为它只需要一个 window 句柄,但是 OP 提到他想在 MFC 应用程序中使用代码。
#include <sstream>
#include <codecvt>
// Convert a multi-byte (ANSI) string returned from std::system_error::what()
// to Unicode (UTF-16).
std::wstring MultiByteToWString( const std::string& s )
{
std::wstring_convert< std::codecvt< wchar_t, char, std::mbstate_t >> conv;
try { return conv.from_bytes( s ); }
catch( std::range_error& ) { return {}; }
}
// A button click handler.
void CMyDialog::OnPropertiesButtonClicked()
{
std::wstring path( L"c:\temp\test.txt" );
// The code also works for the following paths:
//std::wstring path( L"c:\temp" );
//std::wstring path( L"C:\" );
//std::wstring path( L"\\127.0.0.1\share" );
//std::wstring path( L"\\127.0.0.1\share\test.txt" );
try
{
ShowPropertiesDialog( GetSafeHwnd(), path );
}
catch( std::system_error& e )
{
std::wostringstream msg;
msg << L"Could not open the properties dialog for:\n" << path << L"\n\n"
<< MultiByteToWString( e.what() ) << L"\n"
<< L"Error code: " << e.code();
AfxMessageBox( msg.str().c_str(), MB_ICONERROR );
}
}
我想显示来自我的 C++ 代码的文件的 Windows 文件属性对话框(在 Windows 7 上,使用 VS 2012)。我找到了下面的代码 CoInitializeEx()
first, as mentioned in the documentation of ShellExecuteEx()
:
// Whether I initialize COM or not doesn't seem to make a difference.
CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);
SHELLEXECUTEINFO info = {0};
info.cbSize = sizeof info;
info.lpFile = L"D:\Test.txt";
info.nShow = SW_SHOW;
info.fMask = SEE_MASK_INVOKEIDLIST;
info.lpVerb = L"properties";
ShellExecuteEx(&info);
此代码有效,即显示属性对话框并且 ShellExecuteEx()
returns TRUE
。但是,在 详细信息 选项卡中,大小 属性 错误并且缺少日期属性:
详细信息 选项卡中的其余属性(例如文件属性)是正确的。奇怪的是,大小和日期属性在 常规 选项卡(最左侧的选项卡)中正确显示。
如果我通过 Windows 资源管理器(文件 → 右键单击 → 属性)打开属性 window,那么 详细信息 选项卡中的所有属性正确显示:
我在不同的驱动器和三台不同的 PC(1x 德语 64 位 Windows 7、1x 英语 64 位 Windows7, 1x 英文 32 位 Windows7).我总是得到相同的结果,即使我 运行 我的程序作为管理员。不过,在(64 位)Windows 8.1 上,代码对我有用。
我发现问题的原始程序是一个 MFC 应用程序,但如果我将以上代码放入控制台应用程序,我会看到同样的问题。
我需要做什么才能在 Windows 7 的 详细信息 选项卡中显示正确的值?有可能吗?
正如 Raymond Chen 所建议的那样,将路径替换为 PIDL (SHELLEXECUTEINFO::lpIDList
) 可使属性对话框在通过 Windows 7 调用时正确显示大小和日期字段15=].
似乎 ShellExecuteEx()
的 Windows 7 实现有问题,因为较新版本的 OS 与 SHELLEXCUTEINFO::lpFile
没有问题。
还有另一种可能的解决方案,涉及创建 IContextMenu
的实例并调用 IContextMenu::InvokeCommand()
方法。我想这就是 ShellExecuteEx()
在幕后所做的事情。向下滚动到 解决方案 2 以获取示例代码。
解决方案 1 - 使用 PIDL 和 ShellExecuteEx
#include <atlcom.h> // CComHeapPtr
#include <shlobj.h> // SHParseDisplayName()
#include <shellapi.h> // ShellExecuteEx()
// CComHeapPtr is a smart pointer that automatically calls CoTaskMemFree() when
// the current scope ends.
CComHeapPtr<ITEMIDLIST> pidl;
SFGAOF sfgao = 0;
// Convert the path into a PIDL.
HRESULT hr = ::SHParseDisplayName( L"D:\Test.txt", nullptr, &pidl, 0, &sfgao );
if( SUCCEEDED( hr ) )
{
// Show the properties dialog of the file.
SHELLEXECUTEINFO info{ sizeof(info) };
info.hwnd = GetSafeHwnd();
info.nShow = SW_SHOWNORMAL;
info.fMask = SEE_MASK_INVOKEIDLIST;
info.lpIDList = pidl;
info.lpVerb = L"properties";
if( ! ::ShellExecuteEx( &info ) )
{
// Make sure you don't put ANY code before the call to ::GetLastError()
// otherwise the last error value might be invalidated!
DWORD err = ::GetLastError();
// TODO: Do your error handling here.
}
}
else
{
// TODO: Do your error handling here
}
当从一个简单的基于对话框的 MFC 应用程序的按钮单击处理程序调用时,此代码在 Win 7 和 Win 10(其他未测试的版本)下对我都有效。
如果您将 info.hwnd
设置为 NULL
,它也适用于控制台应用程序(只需从示例代码中删除行 info.hwnd = GetSafeHwnd();
,因为它已经用 0 初始化)。在 SHELLEXECUTEINFO 参考中指出 hwnd
成员是可选的。
不要忘记在应用程序启动时强制调用 CoInitialize()
或 CoInitializeEx()
并在关闭时强制调用 CoUninitialize()
以正确初始化和取消初始化 COM。
备注:
CComHeapPtr
is a smart pointer included in ATL that automatically calls CoTaskMemFree()
when the scope ends. It's an ownership-transferring pointer with semantics similar to the deprecated std::auto_ptr
。也就是说,当你将一个CComHeapPtr
对象赋值给另一个对象,或者使用带有CComHeapPtr
参数的构造函数时,原来的对象将变成一个NULL指针。
CComHeapPtr<ITEMIDLIST> pidl2( pidl1 ); // pidl1 allocated somewhere before
// Now pidl1 can't be used anymore to access the ITEMIDLIST object.
// It has transferred ownership to pidl2!
我仍在使用它,因为它开箱即用,可以与 COM APIs 一起使用。
解决方案 2 - 使用 IContextMenu
以下代码需要 Windows Vista 或更新版本,因为我使用的是 "modern" IShellItem
API.
我将代码包装到函数 ShowPropertiesDialog()
中,该函数采用 window 句柄和文件系统路径。如果发生任何错误,该函数将抛出 std::system_error
异常。
#include <atlcom.h>
#include <string>
#include <system_error>
/// Show the shell properties dialog for the given filesystem object.
/// \exception Throws std::system_error in case of any error.
void ShowPropertiesDialog( HWND hwnd, const std::wstring& path )
{
using std::system_error;
using std::system_category;
if( path.empty() )
throw system_error( std::make_error_code( std::errc::invalid_argument ),
"Invalid empty path" );
// SHCreateItemFromParsingName() returns only a generic error (E_FAIL) if
// the path is incorrect. We can do better:
if( ::GetFileAttributesW( path.c_str() ) == INVALID_FILE_ATTRIBUTES )
{
// Make sure you don't put ANY code before the call to ::GetLastError()
// otherwise the last error value might be invalidated!
DWORD err = ::GetLastError();
throw system_error( static_cast<int>( err ), system_category(), "Invalid path" );
}
// Create an IShellItem from the path.
// IShellItem basically is a wrapper for an IShellFolder and a child PIDL, simplifying many tasks.
CComPtr<IShellItem> pItem;
HRESULT hr = ::SHCreateItemFromParsingName( path.c_str(), nullptr, IID_PPV_ARGS( &pItem ) );
if( FAILED( hr ) )
throw system_error( hr, system_category(), "Could not get IShellItem object" );
// Bind to the IContextMenu of the item.
CComPtr<IContextMenu> pContextMenu;
hr = pItem->BindToHandler( nullptr, BHID_SFUIObject, IID_PPV_ARGS( &pContextMenu ) );
if( FAILED( hr ) )
throw system_error( hr, system_category(), "Could not get IContextMenu object" );
// Finally invoke the "properties" verb of the context menu.
CMINVOKECOMMANDINFO cmd{ sizeof(cmd) };
cmd.lpVerb = "properties";
cmd.hwnd = hwnd;
cmd.nShow = SW_SHOWNORMAL;
hr = pContextMenu->InvokeCommand( &cmd );
if( FAILED( hr ) )
throw system_error( hr, system_category(),
"Could not invoke the \"properties\" verb from the context menu" );
}
在下文中,我展示了如何使用来自 CDialog 派生的 class 的按钮处理程序的 ShowPropertiesDialog()
的示例。实际上 ShowPropertiesDialog()
是独立于 MFC 的,因为它只需要一个 window 句柄,但是 OP 提到他想在 MFC 应用程序中使用代码。
#include <sstream>
#include <codecvt>
// Convert a multi-byte (ANSI) string returned from std::system_error::what()
// to Unicode (UTF-16).
std::wstring MultiByteToWString( const std::string& s )
{
std::wstring_convert< std::codecvt< wchar_t, char, std::mbstate_t >> conv;
try { return conv.from_bytes( s ); }
catch( std::range_error& ) { return {}; }
}
// A button click handler.
void CMyDialog::OnPropertiesButtonClicked()
{
std::wstring path( L"c:\temp\test.txt" );
// The code also works for the following paths:
//std::wstring path( L"c:\temp" );
//std::wstring path( L"C:\" );
//std::wstring path( L"\\127.0.0.1\share" );
//std::wstring path( L"\\127.0.0.1\share\test.txt" );
try
{
ShowPropertiesDialog( GetSafeHwnd(), path );
}
catch( std::system_error& e )
{
std::wostringstream msg;
msg << L"Could not open the properties dialog for:\n" << path << L"\n\n"
<< MultiByteToWString( e.what() ) << L"\n"
<< L"Error code: " << e.code();
AfxMessageBox( msg.str().c_str(), MB_ICONERROR );
}
}