zz from msdn
Name Decoration名稱修飾
通常這涉及C++的命名習慣，但是這也涉及很多非C++情況。C++中默認是使用函數的名稱，實參類型，以及返回類型來命名其名稱。對於下面函數，
void CALLTYPE test(void)
鏈接器中的函數名稱會根據調用類型的不同以及使用了何種語言而變化。調用類型即指，可以改變一個函數或者變量的命名方式
|
Calling convention
|
extern “C” or .C file
|
.CPP , .CXX or /TP
|
|
C naming convention (__cdecl)
|
_test
|
?test@@ZAXXZ
|
|
Fastcall naming convention (__fastcall)
|
@test@0
|
?test@@YIXXZ
|
|
Standard Call naming convention (__stdcall)
|
_test@0
|
?test@@YGXXZ
|
當在C++程序中調用一個C函數時，要使用extern “C”。 extern “C”強迫使用對non-class C++函數使用C的命名方式。
函數原型如果參數不匹配，就會引起錯誤。名稱修飾將函數的參數集成到最終修飾完畢的函數名稱中，調用一個所含參數類型不匹配的函數，也會引起LNK2001。
解讀輸出
如果一個符號無法解析，您可以通過以下準則獲取有關函數的信息：
在x86平臺上，對在C文件中，或者C + +文件中extern "C"修飾的函數/變量，採取不同的調用方式時的命名如下：
__cdecl
Function has an underscore (_) prefix.函數有一個下劃線(_)前綴
__stdcall
Function has an underscore (_) prefix and an @ suffix followed by the dword aligned size of parameters on the stack. 函數有一個下劃線(_)前綴，而且有一個@後綴，其後緊跟的是棧內參數的大小（四字節對齊）
__fastcall
Function has an @ prefix and an @ suffix followed by the dword aligned size of parameters on the stack. 函數不僅有一個@前綴，而且有一個@後綴，其後緊跟的是棧內參數的大小（四字節對齊）
Use undname.exe to get the undecorated form of a decorated name.
zz 抄微軟動態庫介紹中的一段
http://www.microsoft.com/china/community/program/OriginalArticles/techdoc/dll.mspx
關於約定
動態庫輸出函數的約定有兩種：調用約定和名字修飾約定。
1)調用約定(Calling convention)：決定函數參數傳送時入棧和出棧的順序，由調用者還是被調用者把參數彈出棧，以及編譯器用來識別函數名字的修飾約定。
函數調用約定有多種，這裏簡單說一下：
1、__stdcall調用約定相當於16位動態庫中經常使用的PASCAL調用約定。在32位的VC++5.0中PASCAL調用約定不再被支持（實際上它已被定義爲__stdcall。除了__pascal外，__fortran和__syscall也不被支持），取而代之的是__stdcall調用約定。兩者實質上是一致的，即函數的參數自右向左通過棧傳遞，被調用的函數在返回前清理傳送參數的內存棧，但不同的是函數名的修飾部分（關於函數名的修飾部分在後面將詳細說明）。
_stdcall是Pascal程序的缺省調用方式，通常用於Win32 Api中，函數採用從右到左的壓棧方式，自己在退出時清空堆棧。VC將函數編譯後會在函數名前面加上下劃線前綴，在函數名後加上"@"和參數的字節數。
2、C調用約定（即用__cdecl關鍵字說明）按從右至左的順序壓參數入棧，由調用者把參數彈出棧。對於傳送參數的內存棧是由調用者來維護的（正因爲如此，實現可變參數的函數只能使用該調用約定）。另外，在函數名修飾約定方面也有所不同。
_cdecl是C和C＋＋程序的缺省調用方式。每一個調用它的函數都包含清空堆棧的代碼，所以產生的可執行文件大小會比調用_stdcall函數的大。函數採用從右到左的壓棧方式。VC將函數編譯後會在函數名前面加上下劃線前綴。是MFC缺省調用約定。
3、__fastcall調用約定是"人"如其名，它的主要特點就是快，因爲它是通過寄存器來傳送參數的（實際上，它用ECX和EDX傳送前兩個雙字（DWORD）或更小的參數，剩下的參數仍舊自右向左壓棧傳送，被調用的函數在返回前清理傳送參數的內存棧），在函數名修飾約定方面，它和前兩者均不同。
_fastcall方式的函數採用寄存器傳遞參數，VC將函數編譯後會在函數名前面加上"@"前綴，在函數名後加上"@"和參數的字節數。
4、thiscall僅僅應用於"C++"成員函數。this指針存放於CX寄存器，參數從右到左壓。thiscall不是關鍵詞，因此不能被程序員指定。
5、naked call採用1-4的調用約定時，如果必要的話，進入函數時編譯器會產生代碼來保存ESI，EDI，EBX，EBP寄存器，退出函數時則產生代碼恢復這些寄存器的內容。
naked call不產生這樣的代碼。naked call不是類型修飾符，故必須和_declspec共同使用。
關鍵字 __stdcall、__cdecl和__fastcall可以直接加在要輸出的函數前，也可以在編譯環境的Setting.../C/C++ /Code Generation項選擇。當加在輸出函數前的關鍵字與編譯環境中的選擇不同時，直接加在輸出函數前的關鍵字有效。它們對應的命令行參數分別爲/Gz、/Gd和/Gr。缺省狀態爲/Gd，即__cdecl。
要完全模仿PASCAL調用約定首先必須使用__stdcall調用約定，至於函數名修飾約定，可以通過其它方法模仿。還有一個值得一提的是WINAPI宏，Windows.h支持該宏，它可以將出函數翻譯成適當的調用約定，在WIN32中，它被定義爲__stdcall。使用WINAPI宏可以創建自己的APIs。
2)名字修飾約定
1、修飾名(Decoration name)
"C"或者"C++"函數在內部（編譯和鏈接）通過修飾名識別。修飾名是編譯器在編譯函數定義或者原型時生成的字符串。有些情況下使用函數的修飾名是必要的，如在模塊定義文件裏頭指定輸出"C++"重載函數、構造函數、析構函數，又如在彙編代碼裏調
用"C""或"C++"函數等。
修飾名由函數名、類名、調用約定、返回類型、參數等共同決定。
2、名字修飾約定隨調用約定和編譯種類(C或C++)的不同而變化。函數名修飾約定隨編譯種類和調用約定的不同而不同，下面分別說明。
a、C編譯時函數名修飾約定規則：
__stdcall調用約定在輸出函數名前加上一個下劃線前綴，後面加上一個"@"符號和其參數的字節數，格式爲_functionname@number。
__cdecl調用約定僅在輸出函數名前加上一個下劃線前綴，格式爲_functionname。
__fastcall調用約定在輸出函數名前加上一個"@"符號，後面也是一個"@"符號和其參數的字節數，格式爲@functionname@number。
它們均不改變輸出函數名中的字符大小寫，這和PASCAL調用約定不同，PASCAL約定輸出的函數名無任何修飾且全部大寫。
b、C++編譯時函數名修飾約定規則：
__stdcall調用約定：
1、以"?"標識函數名的開始，後跟函數名；
2、函數名後面以"@@YG"標識參數表的開始，後跟參數表；
3、參數表以代號表示：
X--void ，
D--char，
E--unsigned char，
F--short，
H--int，
I--unsigned int，
J--long，
K--unsigned long，
M--float，
N--double，
_N--bool，
....
PA--表示指針，後面的代號表明指針類型，如果相同類型的指針連續出現，以"0"代替，一個"0"代表一次重複；
4、參數表的第一項爲該函數的返回值類型，其後依次爲參數的數據類型,指針標識在其所指數據類型前；
5、參數表後以"@Z"標識整個名字的結束，如果該函數無參數，則以"Z"標識結束。
其格式爲"?functionname@@YG*****@Z"或"?functionname@@YG*XZ"，例如
int Test1（char *var1,unsigned long）-----“?Test1@@YGHPADK@Z”
void Test2（） -----“?Test2@@YGXXZ”
__cdecl調用約定：
規則同上面的_stdcall調用約定，只是參數表的開始標識由上面的"@@YG"變爲"@@YA"。
__fastcall調用約定：
規則同上面的_stdcall調用約定，只是參數表的開始標識由上面的"@@YG"變爲"@@YI"。
VC++對函數的省缺聲明是"__cedcl",將只能被C/C++調用.
