If the documentation says that you have to call a function, then you have to call it. It may be that the function doesn’t do anything, but that doesn’t prevent it from doing something in the future.<\/p>\n
Today’s example is the function However, some people noticed that on Windows NT 4, the Unicode version of the The problem with this technique was that if somebody called Oops. <\/p>\n To fix this, the Programs that followed the specification and called Programs that coded to the implementation rather than the specification are now in a world of hurt. If they simply skipped the “useless” call to There’s sometimes a reason for the rules that seem stupid at first glance. (“Call this function that doesn’t do anything.”) Changes to the implementation may make them less stupid in the future. <\/p>\n (Credit goes to my colleague Neill Clift for providing the information that led to today’s article.) <\/p>\n","protected":false},"excerpt":{"rendered":" If the documentation says that you have to call a function, then you have to call it. It may be that the function doesn’t do anything, but that doesn’t prevent it from doing something in the future. Today’s example is the function GetEnvironmentStrings, which returns you all the environment variables of the current process in […]<\/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":[2],"class_list":["post-20763","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-history"],"acf":[],"blog_post_summary":" If the documentation says that you have to call a function, then you have to call it. It may be that the function doesn’t do anything, but that doesn’t prevent it from doing something in the future. Today’s example is the function GetEnvironmentStrings, which returns you all the environment variables of the current process in […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/20763","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=20763"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/20763\/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=20763"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=20763"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=20763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}GetEnvironmentStrings<\/code>, which returns you all the environment variables of the current process in a single block, which you can then study at your leisure. When you’re finished, you’re supposed to call FreeEnvironmentStrings<\/code>. That’s what the documentation says, and if you did that, then you’re in good shape. <\/p>\nFreeEnvironmentStrings<\/code> function didn’t do anything. In other words, the Unicode environment block didn’t need to be freed. When you called GetEnvironmentStrings<\/code>, the kernel just returned you a raw pointer to the real live<\/i> environment strings (which, since this is Windows NT, are kept in Unicode internally). Since nothing was allocated, there was nothing to free. <\/p>\nSetEnvironmentVariable<\/code> in the meantime, the environment block changed out from under the caller of GetEnvironmentStrings<\/code>. <\/p>\nGetEnvironmentStrings<\/code> function was changed to return a copy of the environment block even if you call the Unicode version<\/i>. The corresponding Unicode FreeEnvironmentStrings<\/code> function frees that environment copy. <\/p>\nFreeEnvironmentStrings<\/code> (even though it didn’t do anything up until now) were in good shape. Their call to FreeEnvironmentStrings<\/code> now frees the memory, and all is right with the world. <\/p>\nFreeEnvironmentStrings<\/code>, they will now find themselves leaking memory. On the other hand, if they gave lip service to FreeEnvironmentStrings<\/code> by calling it, but using the memory anyway, they will find themselves accessing invalid heap memory, and all sorts of havoc can ensue. <\/p>\n