{"id":24103,"date":"2007-12-19T10:00:00","date_gmt":"2007-12-19T10:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2007\/12\/19\/how-do-i-mark-a-shortcut-file-as-requiring-elevation\/"},"modified":"2007-12-19T10:00:00","modified_gmt":"2007-12-19T10:00:00","slug":"how-do-i-mark-a-shortcut-file-as-requiring-elevation","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20071219-00\/?p=24103","title":{"rendered":"How do I mark a shortcut file as requiring elevation?"},"content":{"rendered":"

\nSpecifying whether elevation is required\nis typically something that is the responsibility of the program.\nThis is done by\n\nadding a requestedExecutionLevel<\/code> element to your manifest<\/a>.\n(Bart De Smet shows you how<\/a>.\n\nCalvin Hsia does the same for your Visual FoxPro programs<\/a>.)\nBut if the program you’re running doesn’t have such a manifest—maybe\nit’s an old program that you don’t have\nany control over—you can create a shortcut to the program and\nmark the shortcut as requiring elevation.\n<\/p>\n

\nTo do this, you set the SLDF_RUNAS_USER<\/code> flag in the\nshortcut attributes.\nHere’s a skeleton program that sets the flag on the shortcut\nwhose path is passed on the command line.\nFor expository purposes, I’ve skimped on the error reporting,\nand just to shake things up, I’ve used ATL smart pointers.\n<\/p>\n

\n#include <windows.h>\n#include <shlobj.h>\n#include <atlbase.h>\nvoid MarkShortcutRunAs(LPCWSTR pszShortcut)\n{\n CComPtr<IPersistFile> sppf;\n if (FAILED(sppf.CoCreateInstance(CLSID_ShellLink))) return;\n if (FAILED(sppf->Load(pszShortcut, STGM_READWRITE))) return;\n CComQIPtr<IShellLinkDataList> spdl(sppf);\n if (!spdl) return;\n DWORD dwFlags;\n if (FAILED(spdl->GetFlags(&dwFlags))) return;\n dwFlags |= SLDF_RUNAS_USER;\n if (FAILED(spdl->SetFlags(dwFlags))) return;\n if (FAILED(sppf->Save(NULL, TRUE))) return;\n wprintf(L\"Succeeded\\n\");\n}\nint __cdecl wmain(int argc, wchar_t *argv[])\n{\n if (argc == 2 && SUCCEEDED(CoInitialize(NULL))) {\n  MarkShortcutRunAs(argv[1]);\n  CoUninitialize();\n }\n return 0;\n}\n<\/pre>\n
\nThere’s not really much to this program.\nIt creates a shell link object\n(CLSID_ShellLink<\/code>) and\nasks it to load from the file whose path is given on the command line.\nIt then uses IShellLinkDataList::GetFlags<\/code> and\nIShellLinkDataList::SetFlags<\/code> to fetch the old flags\nand set new flags that include SLDF_RUNAS_USER<\/code>.\nOnce that’s done, it saves the result back out.\n<\/p>\n
\nThe hard part was knowing that the SLDF_RUNAS_USER<\/code>\nflag existed in the first place.\n<\/p>\n
\n(I fear that most people will read this article and say,\n“Awesome! My program requires elevation, and this is how I can\nmark my Start menu shortcut to prompt for elevation.\nThanks, Raymond!”\nThese people will have completely ignored the opening paragraph,\nwhich explains that that is the wrong thing to do<\/i>.)<\/p>\n","protected":false},"excerpt":{"rendered":"
Specifying whether elevation is required is typically something that is the responsibility of the program. This is done by adding a requestedExecutionLevel element to your manifest. (Bart De Smet shows you how. Calvin Hsia does the same for your Visual FoxPro programs.) But if the program you’re running doesn’t have such a manifest—maybe it’s an […]<\/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-24103","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Specifying whether elevation is required is typically something that is the responsibility of the program. This is done by adding a requestedExecutionLevel element to your manifest. (Bart De Smet shows you how. Calvin Hsia does the same for your Visual FoxPro programs.) But if the program you’re running doesn’t have such a manifest—maybe it’s an […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/24103","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=24103"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/24103\/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=24103"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=24103"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=24103"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}