{"id":94495,"date":"2016-10-12T07:00:00","date_gmt":"2016-10-12T21:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/?p=94495"},"modified":"2019-03-13T10:32:29","modified_gmt":"2019-03-13T17:32:29","slug":"20161012-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20161012-00\/?p=94495","title":{"rendered":"Nasty gotcha: The inadvertently named resource"},"content":{"rendered":"

In the resources of a Win32 module, resource files<\/a>, you can identify a resource by number (ordinal) or by name (string). One horrific gotcha of the resource file format is that it doesn’t require you to quote strings that are used to name resources. <\/p>\n

Suppose you have this resource header file. <\/p>\n

\n\/\/ resource.h\n\n#define IDD_ENTERPASSWORD 100\n<\/pre>\n
and you use it in your resource file like this: <\/p>\n
\n#include <resource.h>\n\nIDD_ENTERPASWORD DIALOG ...\nBEGIN\n    ...\nEND\n<\/pre>\n
And your code tries to use the dialog like this: <\/p>\n
\nDialogBox(g_hinst, MAKEINTRESOURCE(IDD_ENTERPASSWORD),\n          hwndParent, DialogProc);\n<\/pre>\n
Everything compiles, but the Dialog­Box<\/code> function returns -1<\/code> without displaying any dialog box. Your breakpoint on the Dialog­Proc<\/code> is never hit. What’s going on? <\/p>\n
What’s going on is that in your resource file, you misspelled “password”. <\/p>\n
\nIDD_ENTERPASWORD<\/u> DIALOG ...\n<\/pre>\n
This typo was not reported by the resource compile because of the strange rule that named resources permit but do not require quotation marks around the name. If you omit the quotation marks, the resource compile will “helpfully” insert them for you. Since IDD_ENTER­PASWORD<\/code> is not defined anywhere, the resource compile assumes you meant <\/p>\n
\n\"IDD_ENTERPASWORD\" DIALOG ...\n<\/pre>\n
and generates a named<\/i> dialog resource called \"IDD_ENTERPASWORD\"<\/code>. If you did this on purpose, then the way you would access the dialog box would be <\/p>\n
\nDialogBox(g_hinst, TEXT(\"IDD_ENTERPASWORD\")<\/font>,\n          hwndParent, DialogProc);\n<\/pre>\n
But you didn’t misspell the symbol on purpose. It was a mistake. You meant IDD_ENTER­PASSWORD<\/code>. And your misspelling cost you dearly: The resource was given the wrong identifier. <\/p>\n
Sucks to be you. <\/p>\n
The diagnosis for this class of problems is to verify that the dialog box you describe does indeed exist. <\/p>\n
\n\/\/ Diagnosing the problem: Let's see if the resource exists.\n\/\/ DialogBox(g_hinst<\/u>, MAKEINTRESOURCE(IDD_ENTERPASSWORD)<\/u>, ...)\n\nauto res = FindResource<\/a>(g_hinst,\n                        MAKEINTRESOURCE(IDD_ENTERPASSWORD),\n                        RT_DIALOG);\n<\/pre>\n
In the debugger, check the return value of Find­Resource<\/code>. If it’s nullptr<\/code>, then the reason the Dialog­Box<\/code> function failed is that the resource didn’t exist. The next step of the investigation would be to find out why the resource isn’t there. <\/p>\n
Maybe you misspelled it. <\/p>\n","protected":false},"excerpt":{"rendered":"
No such thing as undefined.<\/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-94495","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
No such thing as undefined.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/94495","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=94495"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/94495\/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=94495"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=94495"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=94495"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}