如何使用 WINAPI 和 C++ 提取可执行文件的文件描述？

Question

我正在尝试提取可执行文件的文件描述。文件描述是在您右键单击文件时看到的描述，选择“属性”，它位于“常规”选项卡中。

我曾尝试使用此处找到的算法：https : //docs.microsoft.com/en-us/windows/desktop/api/winver/nf-winver-verqueryvaluea但对于某些文件，返回的文件描述为空，尽管我可以看到它在“属性”窗口中。例如，如果我创建一个可执行文件，返回的文件描述将为空，但在“属性”窗口中，其文件描述与其名称相同。如何提取每个在“常规”选项卡中有一个可执行文件的文件描述而不是空字符串？

我按以下顺序使用这些功能：

获取文件版本信息大小

获取文件版本信息

查询值

StringCchPrintfW

查询值

StringCchCopyNW

有时在 VerQueryValue 处失败，有时在 GetFileVersionInfo 处失败。我还注意到 Microsoft.Photos.exe 失败

Answer 1

如果您想模仿 shell 行为，请使用 shell API，特别是它的属性 system。

属性对话框中显示的大部分数据都可以使用一组预定义的常量进行查询，这些常量在“Propkey.h”中定义。在这种情况下，我们需要System.FileDescription 属性。要查询它，我们需要它的 PKEY，即PKEY_FileDescription.

查询属性的最简单方法之一是IShellItem2::GetString()方法。out 参数ppsz返回一个指向字符串的指针，必须使用CoTaskMemFree(). 参考文献中没有提到这一点，但这是释放 shell 为您分配的内存的常用方法。

要从文件系统路径获取 IShellItem2 接口，我们可以使用SHCreateItemFromParsingName().

在以下示例中，我已将可重用代码封装在函数中GetShellPropStringFromPath()。

示例 C++ 控制台应用程序：

#include <Windows.h>
#include <ShlObj.h>    // Shell API
#include <Propkey.h>   // PKEY_* constants
#include <atlbase.h>   // CComPtr, CComHeapPtr
#include <iostream>
#include <io.h>
#include <fcntl.h>
#include <string>
#include <system_error>

// Wrapper for SHCreateItemFromParsingName(), IShellItem2::GetString()
// Throws std::system_error in case of any error.
std::wstring GetShellPropStringFromPath( LPCWSTR pPath, PROPERTYKEY const& key )
{
    // Use CComPtr to automatically release the IShellItem2 interface when the function returns
    // or an exception is thrown.
    CComPtr<IShellItem2> pItem;
    HRESULT hr = SHCreateItemFromParsingName( pPath, nullptr, IID_PPV_ARGS( &pItem ) );
    if( FAILED( hr ) )
        throw std::system_error( hr, std::system_category(), "SHCreateItemFromParsingName() failed" );
    
    // Use CComHeapPtr to automatically release the string allocated by the shell when the function returns
    // or an exception is thrown (calls CoTaskMemFree).
    CComHeapPtr<WCHAR> pValue;
    hr = pItem->GetString( key, &pValue );
    if( FAILED( hr ) )
        throw std::system_error( hr, std::system_category(), "IShellItem2::GetString() failed" );

    // Copy to wstring for convenience
    return std::wstring( pValue );
}

int main()
{
    CoInitialize( nullptr );   // TODO: error handling
    _setmode( _fileno( stdout ), _O_U16TEXT );  // for proper UTF-16 console output

    try
    {
        // Show some properties of Microsoft.Photos.exe (adjust path if necessary)
        LPCWSTR path = LR"(C:\Program Files\WindowsApps\Microsoft.Windows.Photos_2018.18061.17410.0_x64__8wekyb3d8bbwe\Microsoft.Photos.exe)";
        std::wcout << L"PKEY_FileDescription:      " 
                   << GetShellPropStringFromPath( path, PKEY_FileDescription ) << std::endl;
        std::wcout << L"PKEY_Software_ProductName: " 
                   << GetShellPropStringFromPath( path, PKEY_Software_ProductName ) << std::endl;
    }
    catch( std::system_error const& e )
    {
        std::cout << "ERROR: " << e.what() << "\nError code: " << e.code() << std::endl;
    }

    CoUninitialize();
}

输出：

PKEY_FileDescription:      Microsoft.Photos.exe
PKEY_Software_ProductName: Microsoft Photos