Win32/COM宽字符字符串对齐要求官方文档查询

核心结论 #

• 官方明确要求宽字符（wchar_t）字符串必须至少按2字节对齐，这是wchar_t类型的基本对齐规则（Windows下wchar_t为2字节大小）。
• 部分Win32内部实现可能隐含4字节对齐的细节，但这属于未公开的实现逻辑，官方不会将其作为强制要求对外声明。

关于SetWindowTextW的静默失败 #

你遇到的函数返回成功但窗口文本未更新的情况，本质是传递了1字节对齐的wchar_t*指针，违反了wchar_t类型的基本对齐要求，属于C++标准中的未定义行为。Windows API在此场景下的表现（返回成功却无实际效果）是未定义行为的具体体现，并非API的设计预期。

官方文档依据 #

• Windows SDK中所有接受LPCWSTR（即const wchar_t*）参数的API，都隐含要求指针指向的内存符合wchar_t的对齐要求。这是基于C++标准中“类型对齐至少等于其大小”的基本规则，Windows平台下wchar_t的对齐要求为2字节。
• COM接口的宽字符字符串参数同样遵循wchar_t的基本对齐要求，COM的内存分配接口（如CoTaskMemAlloc）保证返回的内存块对齐度至少为8字节，自然满足wchar_t的对齐需求。

关于MSVC中wchar_t字面量的4字节对齐 #

MSVC默认将宽字符字面量按4字节对齐，这是编译器的优化行为，而非Win32 API的强制要求。你可以通过alignas(2)调整对齐方式，只要最终传递给API的指针满足至少2字节对齐，就不会出现异常。1字节对齐的情况属于严重违反类型规则，必然触发未定义行为。

复现代码问题分析 #

你的测试代码中，通过memcpy将宽字符字符串复制到char buffer[50]的偏移1字节位置，得到的wchar_t*指针是1字节对齐的，完全不符合wchar_t的对齐要求。此时调用SetWindowTextW属于未定义行为，API的任何表现（包括返回成功但不生效）都是合理的。

内容的提问来源于stack exchange，提问作者Krishty