与具有字符串输出参数的WinAPI函数有多大的一致性？

Question

我最近开始在Windows上用C语言编写程序，并一直在努力小心处理字符串缓冲区的不同方式。例如，GetWindowText（）接受最大字符数的int nMaxCount，包括nullGetModuleFileName（）获取缓冲区大小的DWORD nSize，单位为TCHARs（我假设这也包括null）。尽管它们的措辞不同，一个使用DWORD，而另一个使用int（为什么类型不同？），行为是一样的，对吗？

两者都返回复制的字符串的长度，不包括null，因此我应该能够重复调用其中一个，将缓冲区大小加倍，直到返回的长度小于传入的缓冲区大小，如下所示：

DWORD buf_size = 1024;
DWORD return_val;
wchar_t *full_path = malloc(buf_size * sizeof(wchar_t));

// double the buffer until it's big enough
while ((return_val = GetModuleFileNameW(NULL, full_path, buf_size)) == buf_size) {
    buf_size *= 2;
    full_path = realloc(full_path, buf_size * sizeof(wchar_t));
}

if (!return_val) {
    fprintf(stderr, "Error in GetModuleFileNameW()\n");
    return NULL;
}

是否所有带有string[out]参数的Windows API函数都以相同的方式工作？是否存在行为不同的单个函数或函数组？（例如，以字节而不是字符为单位的缓冲区大小的函数，或不包含空字符的最大字符串长度的函数，或返回与这两个不同的值的函数）

实际上，我刚刚注意到这两个函数的返回值并不完全一致：GetModuleFileName（）在出错时返回0<每当窗口文本有空字符串时，code>GetWindowText（）将返回0，我想我在枚举窗口时经常看到空字符串。。。

我想详细了解它的一个原因是，在某些情况下（GetModuleFileName（）在WinXP上），代码中的一个off-by-One错误将导致字符串不是以null结尾的。

Answer 1

基本上，大多数返回字符串的Win32 API函数都是以一致的方式执行的GetWindowText对于规范的此类函数来说是一个不错的选择。然而，也有例外，我认为从来没有人编制过一份全面的清单。

这里的底线是，每次编写代码调用Win32应用编程接口函数时，您都需要仔细咨询留档。不仅仅是关于字符串输出值的处理，还有所有参数的处理。和所有返回值。和错误处理。整个应用编程接口的风格有所不同，甚至相关函数组也有所不同。