使用實例如下:
#ifdef UNICODE
#define CreateWindowEx CreateWindowExW
#else
#define CreateWindowEx CreateWindowExA
#endif //!UNICODE
在Unicode與ANSI之間轉換字符串
Wi n d o w s 函數M u l t i B y t e To Wi d e C h a r 用于將多字節字符串轉換成寬字符串。下面顯示了M u l t i B y t e To Wi d e C h a r 函數。
int MultiByteToWideChar(
UINT CodePage, //code page
DWORD dwFlags, //character-type options
LPCSTR lpMultiByteStr, //address of string to map
int cchMultiByte, //number of bytes in string
LPWSTR lpWideCharStr, //address of wide-character buffer
int cchWideChar //size of buffer
);
u C o d e P a g e 參數用于標識一個與多字節字符串相關的代碼頁號。d w F l a g s 參數用于設定另一個控件，它可以用重音符號之類的區分標記來影響字符。這些標志通常并不使用，在d w F l a g s參數中傳遞0 。p M u l t i B y t e S t r 參數用于設定要轉換的字符串，c c h M u l t i B y t e 參數用于指明該字符串的長度（按字節計算）。如果為c c h M u l t i B y t e 參數傳遞- 1 ，那么該函數用于確定源字符串的長度。
轉換后產生的U n i c o d e 版本字符串將被寫入內存中的緩存，其地址由p Wi d e C h a r S t r 參數指定。必須在c c h Wi d e C h a r 參數中設定該緩存的最大值（以字符為計量單位）。如果調用M u l t i B y t e To Wi d e C h a r ，給c c h Wi d e C h a r 參數傳遞0 ，那么該參數將不執行字符串的轉換，而是返回為使轉換取得成功所需要的緩存的值。一般來說，可以通過下列步驟將多字節字符串轉換成U n i c o d e 等價字符串：
1) 調用M u l t i B y t e To Wi d e C h a r 函數，為p Wi d e C h a r S t r 參數傳遞N U L L ，為c c h Wi d e C h a r 參數傳遞0 。
2) 分配足夠的內存塊，用于存放轉換后的U n i c o d e 字符串。該內存塊的大小由前面對M u l t B y t e To Wi d e C h a r 的調用返回。
3) 再次調用M u l t i B y t e To Wi d e C h a r ，這次將緩存的地址作為p Wi d e C h a r S t r 參數來傳遞，并傳遞第一次調用M u l t i B y t e To Wi d e C h a r 時返回的緩存大小，作為c c h Wi d e c h a r 參數。
4. 使用轉換后的字符串。
5) 釋放U n i c o d e 字符串占用的內存塊。
函數Wi d e C h a r To M u l t i B y t e 將寬字符串轉換成等價的多字節字符串，如下所示：
int WideCharToMultiByte(
UINT CodePage, // code page
DWORD dwFlags, // performance and mapping flags
LPCWSTR lpWideCharStr, // address of wide-character string
int cchWideChar, // number of characters in string
LPSTR lpMultiByteStr, // address of buffer for new string
int cchMultiByte, // size of buffer
LPCSTR lpDefaultChar, // address of default for unmappable
// characters
LPBOOL lpUsedDefaultChar // address of flag set when default
// char. used
);
該函數與M u l t i B i t e To Wi d e C h a r 函數相似。同樣，u C o d e P a g e 參數用于標識與新轉換的字符串相關的代碼頁。d w F l a g s 則設定用于轉換的其他控件。這些標志能夠作用于帶有區分符號的字符和系統不能轉換的字符。通常不需要為字符串的轉換而擁有這種程度的控制手段，你將為d w F l a g s 參數傳遞0 。
p Wi d e C h a r S t r 參數用于設定要轉換的字符串的內存地址，c c h Wi d e C h a r 參數用于指明該字符串的長度（用字符數來計量）。如果你為c c h Wi d e C h a r 參數傳遞- 1 ，那么該函數用于確定源字符串的長度。
轉換產生的多字節版本的字符串被寫入由p M u l t i B y t e S t r 參數指明的緩存。必須在c c h M u l t i B y t e參數中設定該緩存的最大值（用字節來計量）。如果傳遞0 作為Wi d e C h a r To M u l t i B y t e 函數的c c h M u l t i B y t e 參數，那么該函數將返回目標緩存需要的大小值。通常可以使用將多字節字符串轉換成寬字節字符串時介紹的一系列類似的事件，將寬字節字符串轉換成多字節字符串。
你會發現，Wi d e C h a r To M u l t i B y t e 函數接受的參數比M u l t i B y t e To Wi d e C h a r 函數要多2 個，即p D e f a u l t C h a r 和p f U s e d D e f a u l t C h a r 。只有當Wi d e C h a r To M u l t i B y t e 函數遇到一個寬字節字符，而該字符在u C o d e P a g e 參數標識的代碼頁中并沒有它的表示法時，Wi d e C h a r To M u l t i B y t e 函數才使用這兩個參數。如果寬字節字符不能被轉換，該函數便使用p D e f a u l t C h a r 參數指向的字符。如果該參數是N U L L （這是大多數情況下的參數值），那么該函數使用系統的默認字符。該默認字符通常是個問號。這對于文件名來說是危險的，因為問號是個通配符。
p f U s e d D e f a u l t C h a r 參數指向一個布爾變量，如果寬字符串中至少有一個字符不能轉換成等價多字節字符，那么函數就將該變量置為T R U E 。如果所有字符均被成功地轉換，那么該函數就將該變量置為FA L S E 。當函數返回以便檢查寬字節字符串是否被成功地轉換后，可以測試該變量。同樣，通常為該測試傳遞N U L L 。
關于如何使用這些函數的詳細說明，請參見Platform SDK 文檔。
如果使用這兩個函數，就可以很容易創建這些函數的U n i c o d e 版本和A N S I 版本。例如，你可能有一個動態鏈接庫，它包含一個函數，能夠轉換字符串中的所有字符。可以像下面這樣編寫該函數的U n i c o d e 版本：
BOOL StringReverseW(PWSTR pWideCharStr)
{
//Get a pointer to the last character in the string.
PWSTR pEndOfStr=pWideCharStr+wcslen(pWideCharStr)-1;
wchar_t cCharT;
//Repeat until we reach the center character
//in the string.
while (pWideCharStr < pEndOfStr)
{
//Save a character in a temporary variable.
cCharT=*pWideCharStr;
//Put the last character in the first character.
*pWideCharStr =*pEndOfStr;
//Put the temporary character in the last character.
*pEndOfStr=cCharT;
//Move in one character from the left.
pWideCharStr++;
//Move in one character from the right.
pEndOfStr--;
}
//The string is reversed; return success.
return(TRUE);
}
你可以編寫該函數的A N S I 版本以便該函數根本不執行轉換字符串的實際操作。你也可以編寫該函數的A N S I 版本，以便該函數它將A N S I 字符串轉換成U n i c o d e 字符串，將U n i c o d e 字符串傳遞給S t r i n g R e v e r s e W 函數，然后將轉換后的字符串重新轉換成A N S I 字符串。該函數類似下面的樣子：
BOOL StringReverseA(PSTR pMultiByteStr)
{
PWSTR pWideCharStr;
int nLenOfWideCharStr;
BOOL fOk = FALSE;
//Calculate the number of characters needed to hold
//the wide_character version of string.
nLenOfWideCharStr = MultiRyteToWideChar(CP_ACP, 0,
pMultiByteStr, -1, NULL, 0);
//Allocate memory from the process's default heap to
//accommodate the size of the wide-character string.
//Don't forget that MultiByteToWideChar returns the
//number of characters,not the number of bytes,so
//you must multiply by the size of wide character.
pWideCharStr = HeapAlloc(GetProcessHeap(), 0,
nLenOfWideCharStr * sizeof(WCHAR));
if (pWideCharStr == NULL)
return(fOk);
//Convert the multibyte string to a wide_character string.
MultiByteToWideChar(CP_ACP, 0, pMulti8yteStr, -1,
pWideCharStr, nLenOfWideCharStr);
//Call the wide-character version of this
//function to do the actual work
fOk = StnngReverseW(pWideCharStr);
if (fOk)
{
//Convert the wide-character string back
//to a multibyte string.
WideCharToMultiByte(CP_ACP, 0, pWideCharStr, -1,
pMultiByteStr, strlen(pMultiByteStr), NULL, NULL);
}
//Free the momory containing the wide-character string.
HeapFree(GetProcessHeap(), 0, pWideCharStr);
return(fOk),
}
最后，在用動態鏈接庫分配的頭文件中，可以像下面這樣建立這兩個函數的原型：
BOOL StringReverseW (PWSTR pWideCharStr);
BOOL StringReverseA (PSTR pMultiByteStr);
#ifdef UNICODE
#define StnngReverse StringReverseW
#else
#define StringRevcrsc StringReverseA
#endif // UNICODE