Getting the display name for a shell property

Today's Little Program takes the symbolic name for a shell property and returns a string suitable for display to the end-user, translated into the user's specified display language.

#include <windows.h>
#include <ole2.h>
#include <propsys.h>
#include <propkey.h>
#include <atlbase.h>
#include <atlalloc.h>

int __cdecl wmain(int argc, PWSTR argv[])
 CCoInitialize init;
 if (SUCCEEDED(init) && argc == 2) {
  CComPtr<IPropertyDescription> spdesc;
  if (SUCCEEDED(PSGetPropertyDescriptionByName(
                   argv[1], IID_PPV_ARGS(&spdesc)))) {
   CComHeapPtr<wchar_t> spszName;
   if (SUCCEEDED(spdesc->GetDisplayName(&spszName))) {
    wprintf(L"%ls\n", static_cast<PWSTR>(spszName));
 return 0;

Run this program with the string System.Music.Album­Artist on the command line, and the result is the message Album artist on English-language systems.

The actual workings of the program is pretty straightward. We ask the property system for an interface that describes the property name, and ask that interface to give us the display name, which we print out.

Nothing fancy here. The trick is just knowing that the function exists in the first place.

Comments (2)
  1. John Doe says:

    Is there a function to list all registered properties, or all properties of an object?

    [You can answer this question yourself. When you implement IShellFolder, how can somebody enumerate all the properties of your objects? -Raymond]
  2. Medinoc says:

    The weird part is that it doesn't return a BSTR. Is there a reason for this?

    [Automation interfaces use BSTR. This is not an automation interface. -Raymond]

Comments are closed.

Skip to main content