{"id":91331,"date":"2015-10-19T07:00:00","date_gmt":"2015-10-19T21:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/20151019-00\/?p=91331\/"},"modified":"2019-03-13T12:20:43","modified_gmt":"2019-03-13T19:20:43","slug":"20151019-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20151019-00\/?p=91331","title":{"rendered":"How do I get the user-customized name of a mapped network drive?"},"content":{"rendered":"

Last time<\/a>, we displayed the names of This PC and Recycle Bin. This time, we’ll look at mapped volumes, because they are a little tricky. <\/p>\n

When you map a network drive, the name in Explorer defaults to something like sharename (\\\\server) (Z:)<\/i>. But you can right-click the label, select Rename, and change it to Awesome<\/i> if you like. <\/p>\n

Let’s try to retrieve the name Awesome<\/i>. Take the program from last time and make these changes: <\/p>\n

\nint __cdecl wmain(int argc, wchar_t **argv)\n{\n  CoInitialize(0);\n  IShellItem* item;\n  SHCreateItemFromParsingName(argv[1], nullptr,\n                              IID_PPV_ARGS(&item));\n  PrintDisplayName(item, SIGDN_NORMALDISPLAY, L\"name\");\n  item->Release();<\/font>\n  CoUninitialize();\n  return 0;\n}\n<\/pre>\n
This prints the display name of whatever you pass on the command line. Let’s say that drive Z: is mapped to \\\\server\\sharename<\/code>. <\/p>\n
Run the program with the command line parameter Z:<\/code>, <\/p>\n
\nname = sharename (\\\\server) (Z:)\n<\/pre>\n
Now go to Explorer and rename the drive to Awesome<\/i>. Then run the program again with Z:<\/code> on the command line. <\/p>\n
\nname = Awesome (Z:)\n<\/pre>\n
Close. We got the Awesome<\/i> part, but the non-awesome drive letter is still there. That sort of makes sense, since Explorer also shows the non-awesome drive letter. <\/p>\n
But what if you really want it without the drive letter? Well, you can ask for a different kind of display name. <\/p>\n
\nint __cdecl wmain(int argc, wchar_t **argv)\n{\n  CoInitialize(0);\n  IShellItem* item;\n  SHCreateItemFromParsingName(argv[1], nullptr,\n                              IID_PPV_ARGS(&item));\n  PrintDisplayName(item, SIGDN_PARENTRELATIVEEDITING<\/font>, L\"name\");\n  item->Release();\n  CoUninitialize();\n  return 0;\n}\n<\/pre>\n
This time, we ask for the parent-relative editing name. This is the name used by the Rename command when you rename an item that is displayed relative to its parent. <\/p>\n
Run the program with Z:<\/code> on the command line, and see what happens: <\/p>\n
\nname = Awesome\n<\/pre>\n
Awesome. <\/p>\n
For those who want to do things the classic way, you can use the SHGDN_IN­FOLDER | SHGDN_FOR­EDITING<\/code> flags. <\/p>\n
Take the second program (the one that uses the classic style) and make these changes: <\/p>\n
\nint __cdecl wmain(int argc, wchar_t **argv)\n{\n  CoInitialize(0);\n  PIDLIST_ABSOLUTE absolute;\n  SHParseDisplayName(argv[1], nullptr, &absolute, 0, nullptr);\n  PrintDisplayName(absolute, SHGDN_INFOLDER | SHGDN_FOREDITING, L\"name\");\n  CoTaskMemFree(absolute);<\/font>\n  CoUninitialize();\n  return 0;\n}\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
Ask the shell. That is, after all, how the shell displays is.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-91331","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Ask the shell. That is, after all, how the shell displays is.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/91331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=91331"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/91331\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=91331"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=91331"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=91331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}