ms-win32

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Invoke for ANY code touching Windows APIs:

*W

*A

functions from kernel32/user32/advapi32/ole32/shell32 and friends, COM interfaces, handles (

HANDLE

HWND

HDC

), registry, services, or shell — in any language, however trivial the snippet.

任何涉及Windows API的代码都需遵循此准则：包括kernel32/user32/advapi32/ole32/shell32等库中的

*W

*A

函数、COM接口、句柄（

HANDLE

、

HWND

、

HDC

）、注册表、服务或Shell相关代码——无论使用何种语言，即使是简单的代码片段也不例外。

Unicode
W
APIs only, never
A
. Text is UTF-16 or UTF-8 only; never
```
CP_ACP
```
or any ANSI/narrow encoding for durable or protocol text.
Bytes are not UTF-16 code units. Honor exact length contracts and terminators; never assume null termination when a length is supplied.
Check documented failure values.
```
FAILED
```
/
```
SUCCEEDED
```
for
```
HRESULT
```
;
```
ERROR_SUCCESS
```
for
```
LSTATUS
```
; capture
```
GetLastError()
```
only where documented — many calls invalidate it.
RAII ownership with matching release for handles, buffers, and COM allocations; never release borrowed or pseudo-handles. Initialize structure size/version fields (
```
cbSize
```
etc.) as documented; use pointer-sized types (
```
DWORD_PTR
```
,
```
INT_PTR
```
) without truncation.

When a rule here conflicts with an API's documented contract, the documented contract wins — note the deviation.

如果此处的规则与API的文档化约定冲突，以文档化约定为准——请注明偏差情况。