C、C++函數和類庫詳解（VC++版）（2016-06-26更新）

時間 2019-11-11

標籤 c++ 函數詳解更新欄目 C&C++ 简体版

原文原文鏈接

C、C++函數和類庫詳解(VC++版)(未完成)html

整理者：赤勇玄心行天道node

QQ：280604597linux

Email：280604597@qq.comios

你們有什麼不明白的地方，或者想要詳細瞭解的地方能夠聯繫我，我會認真回覆的git

1 可執行程序編譯流程

文件名程序員	目錄位置shell	解決方案資源管理器位置數據庫	說明編程
Projname.rcwindows	Projname	源文件	項目的資源腳本文件。資源腳本文件包含以下內容，具體取決於項目的類型和爲項目選擇的支持（例如工具欄、對話框或 HTML）：默認菜單定義。快捷鍵和字符串表。默認「關於」對話框。其餘對話框。圖標文件(res\Projname.ico)。版本信息。位圖。工具欄。 HTML文件。資源文件包含標準 Microsoft 基礎類資源的文件 Afxres.rc。一個項目最多隻能有一個資源腳本文件。
Resource.h	Projname	頭文件	包含項目使用的資源定義的資源頭文件。
Projname.rc2	Projname\res	源文件	包含項目使用的附加資源的腳本文件。能夠在項目的.rc文件的頂部包括.rc2文件。 .rc2文件用於存放由多個不一樣項目使用的資源。沒必要爲不一樣的項目屢次建立相同的資源，而是能夠將它們放在一個.rc2文件中，而後將該.rc2文件包括在主.rc文件中。一個項目最多隻能有一個附加資源的腳本文件。
Projname.def	Projname	源文件	DLL項目的模塊定義文件。對於控件，它提供控件的名稱和說明以及運行時堆的大小。一個項目最多隻能有一個模塊定義文件。
Projname.ico	Projname\res	資源文件	項目或控件的圖標文件。該圖標在應用程序最小化時出現。它還用在應用程序的「關於」框中。默認狀況下，MFC提供MFC圖標，ATL提供ATL圖標。
ProjnameDoc.ico	Projname\res	資源文件	包括文檔/視圖結構支持的MFC項目的圖標文件。
Toolbar.bmp	Projname\res	資源文件	表示工具欄或調色板中的應用程序或控件的位圖文件。該位圖包含在項目的資源文件中。初始工具欄和狀態欄在CMainFrame類中構造。

2 函數庫

2.1 函數模板(未完成)

函數名稱	xxx
頭文件	#include <xxx.h> #include <xxx.h>
庫文件	#pragma comment(lib, "xxx.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.2 內存分配

2.2.1 realloc

函數名稱	realloc
頭文件	#include <stdlib.h> #include <malloc.h>
庫文件	無
函數功能	調整一塊已分配的舊內存的長度，或者直接分配一塊新內存。
函數聲明	void * realloc ( void * ptr, size_t size );
函數參數	ptr，[輸入]：已分配的舊內存指針。若是爲NULL，表示直接分配一塊新內存，此時本函數就相似malloc()函數。
函數參數	size，[輸入]：新內存的長度，單位字節。若是爲0，表示釋放已分配的舊內存。若是新內存比舊內存大，再把舊內存的數據所有拷貝過來，新內存的指針與舊內存可能同樣，也可能不同，擴大的內存部分裏的數據是未被初始化過的。若是新內存比舊內存小，就會把舊內存截斷做爲新內存，新內存的指針與舊內存同樣，被截斷的數據會丟失。若是新內存和舊內存同樣大，將不作任何改動。
返回值	非NULL：新內存的指針。 NULL：失敗，已分配的舊內存的長度、指針和數據都不會改變。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	若是內存再也不使用時，記得調用free()釋放內存，防止內存泄露。分配的內存是全局的，在整個進程內有效。舊內存必須是先前經過調用malloc(), calloc(), 或realloc()函數分配的。

2.2.2 malloc

函數名稱	malloc
頭文件	#include <stdlib.h> #include <malloc.h>
庫文件	無
函數功能	分配一塊指定長度的內存。
函數聲明	void * malloc ( size_t size );
函數參數	size，[輸入]：存放內存的長度的值，單位字節。
返回值	非NULL：分配的內存的指針。 NULL：失敗，調用errno變量查看錯誤碼。
錯誤碼	ENOMEM：內存不足。
線程安全	是
原子操做	是
其餘說明	若是內存再也不使用時，記得調用free()釋放內存，防止內存泄露。分配的內存是全局的，整個進程均可以使用。分配的內存裏的數據是未被初始化過的。

2.2.3 calloc

函數名稱	calloc
頭文件	#include <stdlib.h> #include <malloc.h>
庫文件	無
函數功能	分配一塊nmemb個子塊長度爲size的內存，子塊與子塊之間是連續的，等同於malloc ( nmemb * size)。
函數聲明	void * calloc ( size_t nmemb, size_t size );
函數參數	nmemb，[輸入]：存放多少個子塊的值。
函數參數	size，[輸入]：存放每一個子塊長度的值，單位字節。
返回值	非NULL：內存的指針。 NULL：失敗，調用errno變量查看錯誤碼。
錯誤碼	ENOMEM：內存不足。
線程安全	是
原子操做	是
其餘說明	若是內存再也不使用時，記得調用free()釋放內存，防止內存泄露。分配的內存是全局的，在整個進程內有效。內存裏的數據是所有被初始化爲0。

2.2.4 _msize

函數名稱	_msize
頭文件	#include <malloc.h>
庫文件	無
函數功能	用於獲取alloc()相關函數或new分配的內存的實際可用的長度，單位字節，此長度等於分配內存時指定的長度。
函數聲明	size_t _msize ( void * memblock );
函數參數	memblock，[輸入]：存放alloc()相關函數或new分配的內存指針。本參數必須是有效指針，且爲起始指針，不能爲內存中間位置的指針，不能爲NULL，不然致使意外結果。
返回值	正整數：分配內存的長度，單位字節。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.2.5 free

函數名稱	free
頭文件	#include <malloc.h>
庫文件	無
函數功能	釋放調用alloc()系列函數分配的內存。
函數聲明	void free ( void * memblock );
函數參數	memblock，[輸入]：存放調用alloc()系列函數分配的內存的內存指針，不能爲無效內存指針，不然會內存讀寫錯誤。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.3 shell命令

2.3.1 _popen(未完成)

函數名稱	_popen
頭文件	#include <stdio.h>
庫文件	無
函數功能	另啓動一個進程執行shell命令，並創建一條管道，能夠將shell命令進程的標準輸入或輸出重定向到這條管道上，調用進程就能夠經過這條管道讀取shell命令啓動的進程的標準輸出，或者也能夠輸出數據到該進程的標準輸入。只能創建一條管道，一條管道只能重定向標準輸入或者標準輸出，不能同時重定向。
函數聲明	FILE * _popen ( const char * command, const char * mode );
函數參數	command，[輸入]：存放shell命令字符串的指針，此命令對應的可執行文件必須是控制檯程序，若是是窗口程序就會致使錯誤。例如："dir /a"是控制檯程序，但不能是"calc"（calc是計算器程序）。若是要重定向串口程序，參考：http://msdn.microsoft.com/zh-cn/library/ms682499.aspx。
函數參數	mode，[輸入]：重定向方式，"r"表示重定向標準輸出，"w"表示重定向標準輸入，"t"表示文本模式，"b"表示二進制模式。"r"和"w"二選一，"t"和"b"二選一。例如："rt"、"rb"、"wt"、"wb"。
返回值	NULL：失敗，讀取errno變量查看錯誤碼。其餘：管道的文件描述符。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	返回的文件描述符能夠調用fgets()、fputs()、fscanf()、fprintf()等函數來操做標準輸入或標準輸出。返回的文件描述符在使用完後必須調用feof()函數關閉。 shell命令啓動的進程不會隨調用進程的退出而退出，而是在執行完後本身退出。

2.3.2 system(未完成)

函數名稱	system
頭文件	#include <stdlib.h>
庫文件	無
函數功能	執行一個shell命令，調用/bin/sh -c "shell命令"來另啓動一個進程執行，命令執行完後此函數才返回。執行命令期間，SIGCHLD信號被鎖定，SIGINT和SIGQUIT信號被忽略。
函數聲明	int system ( const char * command );
函數參數	command，[輸入]：要執行的shell命令的字符串。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	此函數在使用/bin/sh啓動執行shell命令時，會丟掉調用進程的setuid和setgid位。

2.3.3 Sleep

函數名稱	Sleep
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	使當前線程暫停運行一段時間，暫停期間線程不佔用CPU資源，且會進行消息循環。
函數聲明	VOID Sleep ( DWORD dwMilliseconds );
函數參數	dwMilliseconds，[輸入]：存放要暫停運行多少毫秒的值，爲INFINITE宏表示無限暫停，爲0表示讓出一次本線程的時間片給其餘線程（用時很短）。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數的準確性會受到軟硬件環境的影響。

2.3.4 Beep(未完成)

函數名稱	Beep
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	讓計算機發出警笛聲。
函數聲明	BOOL Beep ( DWORD dwFreq, DWORD dwDuration );
函數參數	dwFreq，[輸入]：存放警笛聲的頻率的值，頻率越高聲音越大，單位Hz，範圍37 Hz至32767 Hz。
函數參數	dwDuration，[輸入]：存放警笛聲的持續時間的值，單位毫秒，若是本參數爲負數，表示不發出警笛聲。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.3.5 GetModuleFileName(未完成)

函數名稱	GetModuleFileName
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	獲取指定模塊的程序文件的絕對路徑字符串，存放到指定的內存。
函數聲明	DWORD GetModuleFileName ( HMODULE hModule, LPSTR lpFilename, DWORD nSize );
函數參數	hModule，[輸入]：一個模塊的句柄。若是是一個DLL模塊的句柄，就獲取DLL庫文件的絕對路徑字符串；若是是一個應用程序的實例句柄，就獲取該應用程序的可執行文件的絕對路徑字符串。若是本參數爲NULL，表示獲取本進程可執行文件的絕對路徑字符串，在DLL模塊中調用也是如此。
	lpFilename，[輸出]：存放絕對路徑字符串的內存指針。
	nSize，[輸入]：存放絕對路徑字符串的內存的最大長度。
返回值	正整數：若是絕對路徑字符串的內存的最大長度足夠大，就返回絕對路徑字符串的長度，不包括\0；若是不夠大，就返回絕對路徑字符串截斷後的長度，包括\0，並設置ERROR_INSUFFICIENT_BUFFER錯誤碼，但winXP系統設置ERROR_SUCCESS錯誤碼。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	若是一個DLL模塊被多個進程加載，獲取到的絕對路徑字符串可能不同。 _pgmptr全局變量會在進程啓動前自動初始化成本進程可執行文件的絕對路徑字符串的內存指針。

2.3.6 SetCurrentDirectory(未完成)

函數名稱	SetCurrentDirectory
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	設置本程序的當前活動目錄。
函數聲明	BOOL SetCurrentDirectory ( LPCSTR lpPathName );
函數參數	lpPathName，[輸入]：存放當前活動目錄字符串的內存指針，能夠是相對或絕對目錄。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.4 文件

2.4.1 打開或建立文件

2.4.1.1 open(未完成)

函數名稱	open
頭文件	#include <sys/types.h> #include <sys/stat.h> #include <fcntl.h>
函數功能	用普通模式打開指定的文件，同時還能夠建立文件。普通模式是指當輸出數據到文件時，會直接輸出到文件，等到數據已經輸出到文件後才返回，能夠保證輸出成功，但會減慢輸出操做。
函數聲明	int open ( const char * pathname, int flags );
函數參數	pathname，[輸入]：存放要打開的文件的路徑字符串的內存指針，能夠是相對或絕對的路徑。不能爲NULL。
函數參數	flags，[輸入]：打開文件時使用的模式和權限。能夠是（用"\|"選一至多個）： O_RDONLY：以只讀方式打開文件。 O_WRONLY：以只寫方式打開文件。 O_RDWR：以可讀寫方式打開文件。以上三種標記只能使用一個，如下的標記沒有限制。 O_CREAT：若是使用此標記，表示若是要打開的文件不存在則建立並打開該文件，若是要打開的文件存在，則直接打開；若是不使用此標記，表示若是要打開的文件不存在，則當即返回失敗並設置ENOENT錯誤碼，若是要打開的文件存在，則直接打開。 O_EXCL：若是使用此標記，並使用O_CREAT標記，表示若是要打開的文件不存在，則建立並打開該文件，若是要打開的文件存在，則當即返回失敗並設置EEXIST錯誤碼。此外，若O_CREAT與O_EXCL同時設置，而且欲打開的文件爲符號鏈接，則會打開文件失敗。若是使用此標記，必須同時使用O_CREAT標記。此標記通常用於檢測文件是不是本進程建立的。 O_NOCTTY：若是使用此標記，表示若是要打開的文件爲終端機設備時，則不會將該終端機當成進程控制終端機。 O_TRUNC：若是使用此標記，並使用可寫方式打開，表示把要打開的文件的長度清爲0，而原來存於該文件的數據也會消失。 O_APPEND：若是使用此標記，表示每次寫文件時都會從文件末尾開始，在NFS文件系統上，若是多個進程同時追加寫入同一個文件時，有可能會致使寫入結果錯亂，由於在此文件系統上的追加功能不是原子操做；若是不使用此標記，表示每次寫文件時從文件指針開始。 O_NONBLOCK：若是使用此標記，表示以非阻塞方式操做打開文件，也就是不管有無數據讀取或等待，都會當即返回。 O_NDELAY：同O_NONBLOCK。 O_SYNC：以同步的方式打開文件。 O_NOFOLLOW：若是參數pathname 所指的文件爲一符號鏈接，則會令打開文件失敗。 O_DIRECTORY：若是參數pathname 所指的文件並不是爲一目錄，則會令打開文件失敗。此爲Linux2.2之後特有的旗標，以免一些系統安全問題。參數mode 則有下列數種組合，只有在創建新文件時纔會生效，此外真正建文件時的權限會受到umask值所影響，所以該文件權限應該爲（mode-umaks）。 S_IRWXU：00700 權限，表示該文件全部者具備可讀、可寫及可執行的權限。 S_IRUSR：00400權限，表示該文件全部者具備可讀取的權限。 S_IWUSR：00200 權限，表示該文件全部者具備可寫入的權限。 S_IXUSR：00100 權限，表示該文件全部者具備可執行的權限。 S_IRWXG：00070權限，表示該文件全部組具備可讀、可寫及可執行的權限。 S_IRGRP：00040 權限，表示該文件全部組具備可讀的權限。 S_IWGRP：00020權限，表示該文件全部組具備可寫入的權限。 S_IXGRP：00010 權限，表示該文件全部組具備可執行的權限。 S_IRWXO：00007權限，表示其餘用戶具備可讀、可寫及可執行的權限。 S_IROTH：00004 權限，表示其餘用戶具備可讀的權限 S_IWOTH：00002權限，表示其餘用戶具備可寫入的權限。 S_IXOTH：00001 權限，表示其餘用戶具備可執行的權限。
返回值	-1：失敗，調用errno變量查看錯誤碼。其餘：被打開文件的普通模式文件描述符。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	要讀取或寫入某個文件，必需要先打開該文件。文件使用完畢後，記得調用close()函數關閉文件描述符，釋放資源。

2.4.1.2 fopen(未完成)

函數名稱	fopen
頭文件	#include <stdio.h>
函數功能	用緩存模式打開指定的文件，同時還能夠建立文件。緩存模式是指當輸出數據到文件時，會先輸出到緩存，函數就當即返回，而後等緩存滿了系統再一次性輸出到文件，能夠減小輸出數據次數，加速輸出效率，但會延遲輸出操做，存在丟數據的可能。
函數聲明	FILE * fopen ( const char * filename, const char * mode );
函數參數	filename，[輸入]：存放要打開的文件的路徑字符串的內存指針，路徑要加文件名，能夠是相對或絕對的路徑。
函數參數	mode，[輸入]：存放用什麼方式打開文件的字符串的內存指針。
返回值	NULL：失敗，調用errno變量查看錯誤碼。其餘：被打開文件的緩存模式文件描述符。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	要讀取或寫入某個文件，必需要先打開該文件。文件使用完畢後，記得調用fclose()函數關閉文件描述符，釋放資源。能夠調用fflush()函數將緩存裏的數據當即輸出到文件。

2.4.1.3 CreateFile(未完成)

函數名稱	CreateFile
頭文件	#include <Windows.h>
函數功能	打開指定的文件，同時還能夠建立文件。
函數聲明	HANDLE CreateFile ( LPCTSTR lpFileName, DWORD dwDesiredAccess, DWORD dwShareMode, LPSECURITY_ATTRIBUTES lpSecurityAttributes, DWORD dwCreationDisposition, DWORD dwFlagsAndAttributes, HANDLE hTemplateFile );
函數參數	lpFileName，[輸入]：存放要打開的文件的路徑字符串的內存指針。
	dwDesiredAccess，[輸入]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.4.2 讀取文件

2.4.2.1 fread(未完成)

函數名稱	fread
頭文件	#include <xxx.h> #include <xxx.h>
函數功能	函數主要功能說明。
函數聲明	類型函數名 (類型參數1, 類型參數2, ……);
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知
其餘說明	…… ……

2.4.3 寫入文件

2.4.3.1 fprintf(未完成)

函數名稱	xxx
頭文件	#include <xxx.h> #include <xxx.h>
函數功能	函數主要功能說明。
函數聲明	類型函數名 (類型參數1, 類型參數2, ……);
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知
其餘說明	"\n"會被自動轉換爲"\r\n"。

2.4.3.2 fputs(未完成)

函數名稱	fputs
頭文件	#include <stdio.h>
函數功能	將字符串輸出到文件。
函數聲明	int fputs ( const char * str, FILE * stream );
函數參數	str，[輸入]：存放要輸出的字符串的內存指針。
函數參數	stream，[輸入]：存放要輸出的文件的緩存模式文件描述符。
返回值	大於等於0：輸出了多少個字節。 -1：失敗。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	若是是直接輸出字符串，不格式化輸出時，fputs()函數效率比fprintf()函數效率高不少。

2.4.3.3 vprintf(未完成)

函數名稱	xxx
頭文件	#include <xxx.h> #include <xxx.h>
函數功能	函數主要功能說明。
函數聲明	類型函數名 (類型參數1, 類型參數2, ……);
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知
其餘說明	…… ……

2.4.4 監測文件

2.4.4.1 select(未完成)

函數名稱	select
頭文件	#include <Ws2tcpip.h>
函數功能	阻塞檢查一個或多個套接字是否處於可讀、可寫或錯誤的狀態。
函數聲明	int select ( int nfds, fd_set FAR * readfds, fd_set FAR * writefds, fd_set FAR * exceptfds, const struct timeval FAR * timeout );
函數參數	nfds，[輸入]：此參數無心義，直接填0，此參數只是爲了與Berkeley套接字兼容。
	readfds，[輸入&輸出]：輸入時，存放須要檢查可讀狀態的套接字組的內存指針，不須要就填NULL。
	writefds，[輸入&輸出]：輸入時，存放須要檢查可寫狀態的套接字組的內存指針，不須要就填NULL。
	exceptfds，[輸入&輸出]：輸入時，存放須要檢查錯誤狀態的套接字組的內存指針，不須要就填NULL。
	timeout，[輸入&輸出]：輸入時，存放阻塞檢查的超時時間的結構體的內存指針。爲NULL表示超時時間爲無限。爲0秒0微秒錶示不阻塞當即返回。
返回值	SOCKET_ERROR宏：失敗，調用WSAGetLastError()函數查看錯誤碼。 0：成功，但在阻塞檢查的超時時間內沒有任何套接字處於須要檢查的狀態。大於0：成功，已經有多少個套接字處於須要檢查的狀態。
線程安全	是
其餘說明

2.4.4.2 FindFirstChangeNotification(未完成)

函數名稱	FindFirstChangeNotification
頭文件	#include <Windows.h>
函數功能	監視指定的目錄中的變化，並返回變化通知句柄。不能監視文件，只能監視目錄。每個變化通知句柄會對應一個惟一的通知隊列，當指定的目錄有要監視的變化行爲時，操做系統就會自動把這條變化通知追加到變化通知句柄對應的通知隊列裏。
函數聲明	HANDLE FindFirstChangeNotification ( LPCTSTR lpPathName, BOOL bWatchSubtree, DWORD dwNotifyFilter );
函數參數	lpPathName，[輸入]：存放要監視的目錄的路徑字符串的內存指針，不能爲文件的路徑。
	bWatchSubtree，[輸入]：存放是否要監視目錄的子項，TRUE表示要，FALSE表示不要。
	dwNotifyFilter，[輸入]：存放要監視哪些變化，能夠是（用'\|'選一至多個）： FILE_NOTIFY_CHANGE_FILE_NAME：只監視文件名稱的變化。不監視目錄名稱的變化。 FILE_NOTIFY_CHANGE_DIR_NAME：只監視目錄名稱的變化。不監視文件名稱的變化。 FILE_NOTIFY_CHANGE_ATTRIBUTES：監視文件和目錄的屬性的變化。 FILE_NOTIFY_CHANGE_SIZE：監視文件實際大小的變化。不監視文件內容和目錄實際大小的變化。 FILE_NOTIFY_CHANGE_LAST_WRITE：監視文件的最後修改時間的變化。 FILE_NOTIFY_CHANGE_LAST_ACCESS：監視文件的最後訪問時間的變化。 FILE_NOTIFY_CHANGE_CREATION：監視文件的建立時間的變化。 FILE_NOTIFY_CHANGE_SECURITY：監視安全屬性的變化。
返回值	INVALID_HANDLE_VALUE：失敗，調用GetLastError()函數查看錯誤碼。其餘：變化通知句柄。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	此函數返回的變化通知句柄能夠調用WaitForSingleObject()函數等待通知隊列裏何時有變化通知，當等待到有變化通知後，WaitForSingleObject()函數會當即返回，而後應該調用FindNextChangeNotification()函數移除最老的一條通知，要否則再次調用WaitForSingleObject()函數時，會由於通知隊列裏有變化通知而當即返回。此函數返回的變化通知句柄只能監視是否有變化，沒法知道具體的變化文件。變化通知句柄使用完後須要調用FindCloseChangeNotification()函數釋放句柄資源。此係列函數沒法區分通知隊列裏存放的具體是哪一個文件或目錄的哪一種變化的通知，只知道有變化。

2.4.4.3 FindNextChangeNotification(未完成)

函數名稱	FindNextChangeNotification
頭文件	#include <Windows.h>
函數功能	根據FindFirstChangeNotification()函數獲取的變化通知句柄，移除變化通知句柄對應的通知隊列裏最老的一條通知，若是通知隊列裏無通知，此函數也返回成功。
函數聲明	BOOL FindNextChangeNotification ( HANDLE hChangeHandle );
函數參數	hChangeHandle，[輸入]：存放變化通知句柄。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.4.4.4 FindCloseChangeNotification(未完成)

函數名稱	FindCloseChangeNotification
頭文件	#include <Windows.h>
函數功能	關閉FindFirstChangeNotification()函數獲取的變化通知句柄，並釋放句柄資源。
函數聲明	BOOL FindCloseChangeNotification ( HANDLE hChangeHandle );
函數參數	hChangeHandle，[輸入]：存放變化通知句柄的值。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.4.4.5 ReadDirectoryChangesW(未完成)

函數名稱	ReadDirectoryChangesW
頭文件	#include <Windows.h>
函數功能	監視一個目錄下的全部改動。
函數聲明	BOOL ReadDirectoryChangesW ( HANDLE hDirectory, LPVOID lpBuffer, DWORD nBufferLength, BOOL bWatchSubtree, DWORD dwNotifyFilter, LPDWORD lpBytesReturned, LPOVERLAPPED lpOverlapped, LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.4.5 移動、複製、刪除、重命名文件

2.4.5.1 SHFileOperation(未完成)

函數名稱	SHFileOperation
頭文件	#include <Shellapi.h>
函數功能	以Shell命令方式移動、複製、刪除、重命名文件或目錄，並指定是否顯示操做過程窗口。
函數聲明	int SHFileOperation ( LPSHFILEOPSTRUCT lpFileOp );
函數參數	lpFileOp，[輸入&輸出]：輸入時，存放對指定文件或目錄的指定操做的Shell命令文件操做結構體的內存指針。詳見SHFILEOPSTRUCT結構體詳解。輸出時，存放其餘信息。
返回值	0：成功，若是用戶取消了操做，也返回成功。非0：失敗。在lpFileOp參數輸出時的fAnyOperationsAborted成員變量查看錯誤碼或具體狀況。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.4.6 移動文件

2.4.6.1 MoveFile(未完成)

函數名稱	MoveFile
頭文件	#include <Windows.h>
函數功能	移動一個已存在的文件或目錄（包括子項）到其餘路徑。
函數聲明	BOOL MoveFile ( LPCSTR lpExistingFileName, LPCSTR lpNewFileName );
函數參數	lpExistingFileName，[輸入]：存放要移動的文件或目錄的路徑字符串的內存指針。
函數參數	lpNewFileName，[輸入]：存放移動後的文件或目錄的路徑字符串的內存指針，此路徑在移動前不能是已存在的，能夠爲相對或絕對路徑。若是要移動文件，本參數的路徑字符串需包含新文件名，不能只包含新文件所在目錄。若是要移動目錄，本參數的路徑字符串需包含新目錄名，不能只包含新目錄所在目錄。要移動的文件與移動後的文件能夠不在同一分區裏，但要移動的目錄與移動後的目錄必須在同一分區裏。文件或目錄的屬性與移動前一致。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	ERROR_FILE_EXISTS(80)宏：移動後的文件或目錄已存在。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	否
其餘說明

2.4.6.2 MoveFileEx(未完成)

函數名稱	MoveFile
頭文件	#include <Windows.h>
函數功能	移動一個已存在的文件或目錄（包括子項）到其餘路徑。
函數聲明	BOOL MoveFileEx ( LPCTSTR lpExistingFileName, LPCTSTR lpNewFileName, DWORD dwFlags );
函數參數	lpExistingFileName，[輸入]：存放要移動的文件或目錄的路徑字符串的內存指針。
	lpNewFileName，[輸入]：存放移動後的文件或目錄的路徑字符串的內存指針，此路徑在移動前不能是已存在的，能夠爲相對或絕對路徑。若是要移動文件，本參數的路徑字符串需包含新文件名，不能只包含新文件所在目錄。若是要移動目錄，本參數的路徑字符串需包含新目錄名，不能只包含新目錄所在目錄。要移動的文件能夠與移動後的文件不在同一分區裏，但要移動的目錄必須與移動後的目錄在同一分區裏。文件或目錄的屬性移動後與移動前一致。
	dwFlags，[輸入]：移動文件時的一些行爲，能夠爲（用'\|'選零至多個）： MOVEFILE_REPLACE_EXISTING：若是設置本標記，表示若是移動後的文件或目錄已存在，就將其替換。若是不設置本標記，表示若是移動後的文件或目錄已存在，就報錯。 MOVEFILE_COPY_ALLOWED：若是設置本標記，則容許要移動的文件或目錄與移動後的文件或目錄在不一樣的分區裏。若是不設置本標記，則不容許，並報ERROR_NOT_SAME_DEVICE錯誤。 MOVEFILE_DELAY_UNTIL_REBOOT：移動操做在系統下次從新啓動時正式進行。這樣即可改換系統文件。若是設置本標記，本函數會把要移動的文件的信息寫入到註冊表項HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SessionManager\PendingFileRenameOperations下，此時本函數的返回值只說明寫入註冊表的操做是否成功。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	ERROR_FILE_EXISTS(80)宏：移動後的文件或目錄的路徑已存在。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	否
其餘說明

2.4.7 刪除文件

2.4.7.1 DeleteFile(未完成)

函數名稱	DeleteFile
頭文件	#include <Windows.h>
函數功能	刪除一個指定的已存在的文件。
函數聲明	BOOL DeleteFile ( LPCTSTR lpFileName );
函數參數	lpFileName，[輸入]：存放要刪除的文件的路徑字符串的內存指針，能夠爲相對或絕對路徑，不能爲NULL。
返回值	非0：成功。 0：失敗，調用GetlastError()函數查看錯誤碼。
錯誤碼	ERROR_FILE_NOT_FOUND宏：要刪除的文件不存在。 ERROR_ACCESS_DENIED宏：要刪除的文件拒絕訪問，可能文件是隻讀文件，或正在被打開，或正在被內存映射等。 ……
線程安全	是
原子操做	是
其餘說明	若是要刪除只讀文件，須要先把文件的只讀屬性去掉。調用本函數的進程必須具備該文件的刪除權限，或者具備該文件所在父目錄的刪除子項權限。本函數不能刪除目錄，刪除非空目錄能夠調用SHFileOperation()函數，刪除空目錄能夠調用RemoveDirectory()函數。若是要刪除的文件已經被打開，或被內存映射，本函數返回失敗。本函數是給要刪除的文件作刪除標記，而不是當即刪除，當該文件的句柄被所有關閉時，文件會被自動刪除。在該文件被作刪除標記期間，若是還有進程調用CreateFile()函數來打開文件，會返回ERROR_ACCESS_DENIED錯誤。若是要刪除的文件是一個Symbolic link符號連接文件，則只會刪除符號連接文件，不會刪除被連接的文件。若是要刪除被連接的文件，能夠調用CreateFile()函數並設置FILE_FLAG_DELETE_ON_CLOSE標記。本函數是直接永久刪除文件，不會把文件移動到回收站。

2.4.8 查找文件

2.4.8.1 FindFirstFile(未完成)

函數名稱	FindFirstFile
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	在指定的路徑下查找名稱相匹配的一個或多個文件或目錄，返回查找句柄。
函數聲明	HANDLE FindFirstFile ( LPCTSTR lpFileName, LPWIN32_FIND_DATA lpFindFileData );
函數參數	lpFileName，[輸入]：存放要查找的路徑字符串的內存指針，支持通配符。例如："C:\\*"，"D:\\doc\\file.doc"。本參數不能爲NULL，或非路徑字符串。若是本參數是含有通配符的路徑，調用進程必須具備上級目錄的訪問權限。
函數參數	lpFindFileData，[輸出]：存放第一個查找到的文件或目錄的屬性的結構體的內存指針。本參數不能爲NULL。
返回值	INVALID_HANDLE_VALUE：失敗，調用GetLastError()函數查看錯誤碼。其餘：成功，查找句柄。
錯誤碼	ERROR_FILE_NOT_FOUND：沒有查找到文件。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是是查找多個文件或目錄，能夠根據本函數返回的查找句柄循環調用FindNextFile()函數獲取文件信息。若是是查找多個文件或目錄，本函數會匹配"."和".."目錄。例如：查找"C:\\*"路徑，會查找出" C:\\."和" C:\\.."目錄本函數返回的查找句柄在不使用後，必須調用FindClose()函數釋放句柄。

2.4.9 文件屬性

2.4.9.1 GetFileSize(未完成)

函數名稱	GetFileSize
頭文件	#include <Windows.h>
函數功能	獲取指定文件的大小，不是佔用空間，且不支持文件夾。
函數聲明	DWORD GetFileSize ( HANDLE hFile, LPDWORD lpFileSizeHigh );
函數參數	hFile，[輸入]：存放文件句柄的值。能夠調用CreateFile()函數獲取文件句柄。
函數參數	lpFileSizeHigh，[輸出]：存放接收文件大小的變量的內存指針，單位字節，能夠爲NULL。
返回值	INVALID_HANDLE_VALUE宏：失敗，調用GetLastError()查看錯誤碼。其餘：文件的大小，單位字節。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	獲取到的是文件的實時大小，不是操做系統緩存記住的大小。

2.4.10 路徑字符串

2.4.10.1 路徑截斷與合併

2.4.10.1.1 PathFindFileName

函數名稱	PathFindFileName
頭文件	#include <Shlwapi.h> #pragma comment(lib, "Shlwapi.lib")
函數功能	獲取路徑字符串裏的文件名子串的起始指針。
函數聲明	char * PathFindFileName ( const char * pPath );
函數參數	pPath，[輸入]：路徑字符串。
返回值	文件名子串的起始指針
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	示例：路徑字符串："c:\path\file" 文件名子串："file" 路徑字符串："c:\path" 文件名子串："path" 路徑字符串："c:\path\" 文件名子串："path\" 路徑字符串："c:\" 文件名子串："c:\" 路徑字符串："c:" 文件名子串："c:" 路徑字符串："path" 文件名子串："path" 路徑字符串："" 文件名子串：""

2.4.10.1.2 PathFindExtension

函數名稱	PathFindExtension
頭文件	#include <Shlwapi.h> #pragma comment(lib, "Shlwapi.lib")
函數功能	獲取路徑字符串裏的文件的擴展名子串的起始指針。若是擴展名出現空格，將返回失敗。
函數聲明	char * PathFindExtension ( const char * pPath );
函數參數	pPath，[輸入]：路徑字符串的內存指針。
返回值	文件擴展名前的'.'字符指針：成功。路徑字符串的'\0'字符指針：失敗。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	一個正確的文件擴展名不能出現空格。示例：路徑字符串："abc.txt" 擴展名子串：".txt" 路徑字符串："abc.txt " 擴展名子串："" 路徑字符串："abc." 擴展名子串："." 路徑字符串："abc" 擴展名子串：""

GetModuleFileName 獲得模塊路徑名

PathRemoveArgs 去除路徑的參數

PathRemoveBackslash 去除路徑最後的反斜槓「\」

PathAddBackslash 在路徑最後加上反斜槓「\」

PathRemoveBlanks 去除路徑先後的空格

PathAddExtension 在文件路徑後面加上擴展名

PathRemoveExtension 去除文件路徑擴展名

PathRenameExtension 更改文件路徑擴展名

PathRemoveFileSpec 去除文件名，獲得目錄

PathUnquoteSpaces 去除路徑中的首尾空格

PathQuoteSpaces 判斷路徑中是否有空格，有的話，就是用「」引號把整個路徑包含起來

PathAppend 將一個路徑追加到另外一個路徑後面

PathCombine 合併兩個路徑

PathSkipRoot 去掉路徑中的磁盤符或UNC部分。

PathStripPath 去掉路徑中的目錄部分，獲得文件名。

PathStripToRoot 去掉路徑的文件部分，獲得根目錄。

PathCompactPath 根據像素值生成符合長度的路徑。

如原始路徑： C:\path1\path2\sample.txt

根據120像素截斷後爲： C:\pat...\sample.txt

根據25像素截斷後爲: ...\sample.txt

PathCompactPathEx 根據字符個數來生成符合長度的路徑。

PathSetDlgItemPath 將路徑數據設置到對話框的子控件上。

PathUndecorate 去除路徑中的修飾——具體還沒看明白，MSDN的例子只是去掉了括號。

PathUnExpandEnvStrings 將路徑中部分數據替換爲系統環境變量格式

2.4.10.2 路徑查找比較函數

PathFindOnPath 從路徑中查找路徑

PathFindExtension 查找路徑的擴展名

PathFindFileName 獲取路徑的文件名

PathFindNextComponent 查找匹配路徑（不太熟悉）

PathFindSuffixArray 查找給定的文件名是否有給定的後綴。

PathGetArgs 獲取路徑參數

PathGetCharType 獲取路徑字符類型

PathGetDriveNumber 根據邏輯盤符返回驅動器序號

2.4.10.3 路徑轉換函數

PathRelativePathTo 建立一個路徑到另外一個路徑的相對路徑。

PathResolve 將一個相對路徑或絕對路徑轉換爲一個合格的路徑，這個理解起來比較拗口。

PathCanonicalize 規範化路徑。將格式比較亂的路徑整理成規範的路徑格式。

PathBuildRoot 根據給定的磁盤序號建立根目錄路徑

CreateDirectory 建立目錄

GetShortPathName 將長路徑轉爲8.3格式的短路徑格式

GetLongPathName 將短路徑格式轉爲長路徑。

PathGetShortPath 將長路徑轉爲短路徑格式（8.3格式）

PathCreateFromUrl 將URL路徑轉爲MS-DOS格式

PathMakePretty 把路徑所有轉爲小寫，增長可讀性。

PathMakeSystemFolder 給路徑增長系統屬性

PathUnmakeSystemFolder 去除路徑中的系統屬性。

PathMakeUniqueName 從模板建立統一的路徑格式——沒用過，不熟悉

PathProcessCommand 生成一個可執行的路徑，好比有參數的，會自動將路徑用「」包含。

這在ShellExecute中比較有用。

2.4.10.4 路徑驗證函數

PathCleanupSpec 去除路徑中不合法的字符

PathCommonPrefix 比較並提取兩個路徑相同的前綴

PathFileExists 驗證路徑是否存在

PathMatchSpec 判斷路徑是否匹配製定的擴展名。

PathIsDirectory 判斷路徑是不是一個有效的目錄

PathIsFileSpec 驗證路徑是否一個文件名（有多是一個路徑）

PathIsExe 驗證路徑是不是可執行文件。注意：不只僅是.exe，還有.bat，.com，.src等

PathIsRoot 路徑是否爲根路徑

PathIsRelative 判斷路徑是不是相對路徑

PathIsContentType 檢測文件是否爲制定類型。

例如：PathIsContentType( 「hello.txt」 ,「text/plain」 ) 返回TRUE

PathIsContentType( 「hello.txt」 ,「image/gif」 ) 返回FALSE

PathIsHTMLFile 判斷路徑是不是html文件類型——根據系統註冊類型判斷。

PathIsLFNFileSpec 判斷路徑是不是長路徑格式

PathIsNetworkPath 判斷路徑是不是一個網絡路徑。

PathIsPrefix 判斷路徑是否含有指定前綴

PathIsSameRoot 判斷路徑是否有相同根目錄

PathIsSlow 判斷路徑是不是一個高度延遲的網絡鏈接——我也不太明白是啥意思。

PathIsSystemFolder 判斷路徑是否有系統屬性（屬性能夠本身設定）

PathIsUNC 路徑是不是UNC格式（網絡路徑）

PathIsUNCServer 路徑是不是UNC服務器

PathIsUNCServerShare 路徑是否僅僅是UNC的共享路徑格式

PathIsURL 路徑是不是http格式。

PathYetAnotherMakeUniqueName 基於已存在的文件，自動建立一個惟一的文件名。比較有用，好比存在「新建文件」，此函數會建立文件名「新建文件（2）」。

2.4.11 標準輸入、輸出和出錯

2.4.11.1 ungetc

函數名稱	ungetc
頭文件	#include <stdio.h>
庫文件	無
函數功能	把一個字符退回到標準輸入文件中的第一個字符，下一次將讀出此字符，不會將此字符寫到文件中和設備上，只將字符退回到標準I/O庫的流緩存區中，此字符不能被正在調用的輸入流函數讀出。
函數聲明	int ungetc ( int c, FILE * stream );
函數參數	c，[輸入]：要退回的字符，只能是ASCII碼的字符，值爲0-255。
函數參數	stream，[輸入]：標準輸入文件句柄，也就是stdin。
返回值	EOF：失敗。其餘：退回的字符c參數。
錯誤碼
線程安全	是或否或未知
其餘說明

2.4.11.2 printf(未完成)

函數名稱

printf

頭文件

#include <stdio.h>

庫文件

無

函數功能

格式化輸出字符串到標準輸出文件。

格式化輸出字符串就是指能夠將一些變量按照必定的格式組合成一個字符串，而後輸出到指定的位置。

函數聲明

int printf (

const char * format,

...

);

函數參數

format，[輸入]：

存放格式化字符串的內存指針，不能爲NULL。

格式化字符串主要是使用'%'號來進行轉義的，用於描述動態參數的輸出格式，轉義格式以下：

格式	%[對齊方式][符號][標誌][對齊填充][最少輸出長度][.精度][長度]格式類型
對齊方式	無	輸出右對齊。
對齊方式	-	輸出左對齊。
符號	無	輸出數值爲正時不冠以任何符號，爲負時冠以'-'負號。
	+	輸出數值爲正時冠以'+'正號，爲負時冠以'-'負號。
	空格	輸出數值爲正時冠以' '空格，爲負時冠以'-'負號。
標誌	#	若是格式類型爲o，則在輸出時加前綴0；若是格式類型爲x，則在輸出時加前綴0x；若是格式類型爲X，則在輸出時加前綴0X；若是格式類型爲e、E、f、F，則老是輸出小數點，即便精度設置爲0；若是格式類型爲g、G，則除了數值爲0外老是顯示小數點；若是格式類型爲其餘類，則無心義；
對齊填充	無	若是爲右對齊，左邊填充空格。若是爲左對齊，右邊填充空格。
對齊填充	0	若是爲右對齊，左邊填充'0'。若是爲左對齊，右邊填充空格。
最少輸出長度	無	輸出時按照實際長度輸出。
	十進制整數	用來表示最少輸出長度。若是實際長度超過該長度，就按實際長度輸出。若是實際長度少於該長度，則按對齊方式輸出。
	*	最少輸出長度從動態參數中指定，必須是不超過long型的整數。
精度	無	輸出時按照標準精度輸出。
	.十進制整數	精度格式符以'.'開頭，後跟十進制整數。若是輸出數字，則表示小數的位數；若實際位數大於所定義的精度數，則四捨五入。若不足則右邊補0。若是輸出的是字符串，則表示輸出字符的個數；若實際位數大於所定義的精度數，則截去超過的部分。若不足則原樣輸出。
	*	精度從動態參數中指定，必須是不超過long型的整數。
長度	h	和整數格式類型一塊兒使用，表示一個short int 或者 unsigned short int 類型數值。例如：「%hu」、「%hx」和「%6.4hd」
	l	和整數格式類型一塊兒使用，表示一個long int 或者unsigned long int 類型值。例如：「%ld」和「%8lu」
	ll	和整數格式類型一塊兒使用，表示一個long long int或 unsigned long long int 類型值 (C99標準)。例如：「%lld」和「%8llu」
	L	和浮點轉換說明符一塊兒使用，表示一個long double值。例如：「%Lf」和「%10.4Le」
	j	和整數轉換說明符一塊兒使用，表示一個intmax_t或uintmax_t值。示例：「%jd」和「%8jX」
	t	和整數轉換說明符一塊兒使用，表示一個ptrdiff_t值(與兩個指針之間的差相對應的類型) (C99標準)。例如：「%td」和「%12ti」
	z	和整數轉換說明符一塊兒使用，表示一個size_t值(sizeof返回的類型) (C99標準)。例如：「%zd」和「%12zx」
格式類型	c	輸出單個ASCII碼字符
	d	輸出有符號十進制整數
	i	輸出有符號十進制整數
	e	以「科學記數法」的形式輸出有符號十進制浮點數，如2.451e+02
	E	以「科學記數法」的形式輸出有符號十進制浮點數，如2.451E+02
	f	輸出有符號十進制浮點數，不帶精度時，保留6位小數
	g	選用e或f格式中較短寬度的一個輸出十進制浮點數，不輸出無效零
	G	選用E或f格式中較短寬度的一個輸出十進制浮點數，不輸出無效零
	o	輸出無符號八進制整數
	p	輸出指針變量的無符號十六進制地址值
	s	輸出char類型字符串
	S	輸出wchar_t類型字符串
	u	輸出無符號十進制整數
	x	輸出無符號小寫十六進制整數，不能輸出有符號的，如1a2b3c4d
	X	輸出無符號大寫十六進制整數，不能輸出有符號的，如1A2B3C4D
	%	輸出字符'%'
	I64	配合u、d等，能夠輸入輸出64位整數。VC++平臺有效。如%I64u，%I64d。注意大寫。

...，[輸入]：

存放格式化字符串中轉義的各個參數。

返回值

輸出字符串的長度，單位字節。

錯誤碼

無

線程安全

是

原子操做

是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合

其餘說明

printf("[%d]", 123);

輸出：[123]

printf("[%10d]", 123);

輸出：[ 123]

printf("[%*d]", 5, 123);

輸出：[ 123]

printf("[%*d]", (long long)5, 123);

輸出：[ 0]

printf("[%-10d]", 123);

輸出：[123 ]

printf("[%+d]", 123);

輸出：[+123]

printf("[% d]", 123);

輸出：[ 123]

printf("[%#o]", 123);

輸出：[0173]

printf("[%#x]", 123);

輸出：[0x7B]

printf("[%#f]", 123.0);

輸出：[123.000000]

2.4.11.3 scanf(未完成)

函數名稱

scanf

頭文件

#include <stdio.h>

庫文件

無

函數功能

從標準輸入文件格式化輸入字符串。

格式化輸入字符串就是指從指定的位置輸入字符串，而後將字符串按照必定的格式拆分並存放到變量。

函數聲明

int scanf (

const char * format,

...

);

函數參數

format，[輸入]：

存放格式化字符串的內存指針，不能爲NULL。

格式化字符串主要是使用'%'號來進行轉義的，用於描述動態參數的輸出格式，轉義格式以下：

格式	%[標誌][最少輸出長度][.精度][長度]格式類型
標誌	#	若是格式類型爲o，則在輸出時加前綴0；若是格式類型爲x，則在輸出時加前綴0x；若是格式類型爲X，則在輸出時加前綴0X；若是格式類型爲e、E、f、F，則當結果老是輸出小數點；若是格式類型爲g、G，則除了數值爲0外老是顯示小數點；若是格式類型爲其餘類，則無心義；
最多輸入長度	無	輸出時按照實際長度輸出。
	十進制整數	用來表示最少輸出長度。若是實際長度超過該長度，就按實際長度輸出。若是實際長度少於該長度，則按對齊方式輸出。
	*	最少輸出長度從動態參數中指定，必須是不超過long型的整數。
長度	h	和整數格式類型一塊兒使用，表示一個short int 或者 unsigned short int 類型數值。例如：「%hu」、「%hx」和「%6.4hd」
	l	和整數格式類型一塊兒使用，表示一個long int 或者unsigned long int 類型值。例如：「%ld」和「%8lu」
	ll	和整數格式類型一塊兒使用，表示一個long long int或 unsigned long long int 類型值 (C99標準)。例如：「%lld」和「%8llu」
	L	和浮點轉換說明符一塊兒使用，表示一個long double值。例如：「%Lf」和「%10.4Le」
	j	和整數轉換說明符一塊兒使用，表示一個intmax_t或uintmax_t值。示例：「%jd」和「%8jX」
	t	和整數轉換說明符一塊兒使用，表示一個ptrdiff_t值(與兩個指針之間的差相對應的類型) (C99標準)。例如：「%td」和「%12ti」
	z	和整數轉換說明符一塊兒使用，表示一個size_t值(sizeof返回的類型) (C99標準)。例如：「%zd」和「%12zx」
格式類型	c	輸出單個ASCII碼字符
	d	輸出十進制有符號整數
	i	輸出十進制有符號整數
	e	以「科學記數法」的形式輸出十進制有符號浮點數，如2.451e+02
	E	以「科學記數法」的形式輸出十進制有符號浮點數，如2.451E+02
	f	輸出十進制的有符號浮點數，不帶域寬時，保留6位小數
	g	選用e或f格式中較短寬度的一個輸出十進制浮點數，不輸出無效零
	G	選用E或f格式中較短寬度的一個輸出十進制浮點數，不輸出無效零
	o	輸出無符號八進制整數
	p	輸出指針的無符號十六進制地址值
	s	輸出char類型字符串
	S	輸出wchar_t類型字符串
	u	輸出無符號十進制整數
	x	輸出無符號小寫十六進制整數 (不輸出前綴Ox)，如1a2b3c4d
	X	輸出無符號大寫十六進制整數 (不輸出前綴Ox)，如1A2B3C4D
	%	輸出字符'%'
	I64	配合u、d等，能夠輸入輸出64位整數。MSVC平臺有效。如%I64u，%I64d。注意大寫

...，[輸出]：

存放格式化字符串中轉義的各個參數。

返回值

返回值1：返回值說明。

返回值2：返回值說明。

……

錯誤碼

EXXXX：錯誤碼說明。

……

線程安全

是或否或未知，表示此函數多線程調用是否會產生影響

原子操做

是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合

其餘說明

……

2.5 內存映射文件

文件內存映射後，讀取速度很快，比把文件內容一次性讀取到內存再讀取內存還要快。

CreateFileMapping 建立內存映射文件句柄，使用前必須已經打開了該文件，不能映射長度爲0的文件的，不然報1006錯誤。

MapViewOfFile 具體將文件中的哪一段映射到內存。

UnmapViewOfFile 釋放映射的內存。

CloseHandle 關閉內存映射句柄。

2.6 文件系統

2.6.1 分區剩餘空間

2.6.1.1 GetDiskFreeSpaceEx(未完成)

函數名稱	GetDiskFreeSpaceEx
頭文件	#include <Windows.h>
函數功能	獲取指定分區的用戶可用空間、用戶總空間和總可用空間。
函數聲明	BOOL WINAPI GetDiskFreeSpaceEx( LPCTSTR lpDirectoryName, PULARGE_INTEGER lpFreeBytesAvailable, PULARGE_INTEGER lpTotalNumberOfBytes, PULARGE_INTEGER lpTotalNumberOfFreeBytes );
函數參數	lpDirectoryName，[輸入]：存放分區上的一個目錄字符串的內存指針，爲NULL表示當前活動目錄所在分區。例如："C:"、"C:\"、"C:\windows"都表示C盤，".\\"表示當前活動目錄所在分區。目錄字符串後面不能加文件名，否側會失敗。目錄字符串只要在指定分區上便可，必須已經存在。調用進程對該分區必須具備FILE_LIST_DIRECTORY權限。
	lpFreeBytesAvailable，[輸出]：存放用於存放用戶可用空間的結構體的內存指針，單位字節，不須要就填NULL。用戶可用空間是指啓動本程序的用戶對指定分區的可用空間，若是啓用了磁盤配額，此參數有可能小於指定分區的總可用空間。
	lpTotalNumberOfBytes，[輸出]：存放用於存放用戶總空間的結構體的內存指針，不須要就填NULL。用戶總空間是指啓動本程序的用戶對指定分區的可用空間與已用空間之和，若是啓用了磁盤配額，此參數有可能小於指定分區的總空間。
	lpTotalNumberOfFreeBytes，[輸出]：存放用於存放總可用空間的結構體的內存指針，不須要就填NULL。總可用空間是指分區的總可用空間。
返回值	非0：成功。 0：失敗。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	本函數獲取的分區爲光驅時，lpFreeBytesAvailable和lpTotalNumberOfFreeBytes參數輸出0，除非刻錄光驅內有空白可寫光盤。

2.7 時鐘

地球分爲24個時區：中時區（+0）、東一區（+1）、東二區（+2）、東三區（+3）、東四區（+4）、東五區（+5）、東六區（+6）、東七區（+7）、東八區（+8）、東九區（+9）、東十區（+10）、東十一區（+11）、東西十二區（+/-12）、西十一區（-11）、西十區（-10）、西九區（-9）、西八區（-8）、西七區（-7）、西六區（-6）、西五區（-5）、西四區（-4）、西三區（-3）、西二區（-2）、西一區（-1）。

中時區也叫UTC通用協調時、UTC協調世界時、GMT格林尼治時，簡稱協調時。

本地時區也叫本地時，是在操做系統中設定的，例如：北京地區，那就是東八區北京時間。

UTC協調時的1970年1月1日00:00:00爲計算機起始時刻，全部的計算機時鐘最先只能設置到這個時刻。

北京時（東八區）的計算機起始時刻爲1970年1月1日08:00:00。

2.7.1 高精度性能計數器

2.7.1.1 QueryPerformanceFrequency(未完成)

函數名稱	QueryPerformanceFrequency
頭文件	#include <Windows.h>
函數功能	查看當前高精度性能計數器的時鐘頻率，若是硬件不支持高精度性能計數器本函數會返回失敗。
函數聲明	BOOL QueryPerformanceFrequency ( LARGE_INTEGER * lpFrequency );
函數參數	lpFrequency，[輸出]：存放當前高精度性能計數器的時鐘頻率的共用體變量的內存指針。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	高精度性能計數器的時鐘頻率就是每秒累加多少次，頻率越高，精度也就越高。

2.7.1.2 QueryPerformanceCounter(未完成)

函數名稱	QueryPerformanceCounter
頭文件	#include <Windows.h>
函數功能	查看當前高精度性能計數器的數值，若是硬件不支持高精度性能計數器本函數會返回失敗。
函數聲明	BOOL QueryPerformanceCounter ( LARGE_INTEGER * lpPerformanceCount );
函數參數	lpPerformanceCount，[輸出]：存放當前高精度性能計數器的數值的共用體變量的內存指針。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	在多處理器的計算機上，每一個處理器都有獨立的高精度性能計數器，因此屢次調用此函數會返回不一樣處理器的數值。若是要爲線程指定處理器相關性，請使用SetThreadAffinityMask()函數。當前高精度性能計數器的數值除以時鐘頻率就是計算機已經運行了多少秒。記錄兩個時刻的高精度性能計數器的數值，相減後得出間隔時間，而後除以時鐘頻率就知道時隔多少秒，多少毫秒，甚至是微秒。

2.7.2 獲取時區

2.7.2.1 GetTimeZoneInformation(未完成)

函數名稱	GetTimeZoneInformation
頭文件	#include <Windows.h>
庫文件	無
函數功能	獲取當前系統的時區。
函數聲明	DWORD WINAPI GetTimeZoneInformation ( LPTIME_ZONE_INFORMATION lpTimeZoneInformation );
函數參數	lpTimeZoneInformation，[輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.7.3 設置時區

2.7.3.1 SetTimeZoneInformation(未完成)

函數名稱	SetTimeZoneInformation
頭文件	#include <xxx.h> #include <xxx.h>
庫文件	#pragma comment(lib, "xxx.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.7.4 獲取時鐘

2.7.4.1 time

函數名稱	time
頭文件	#include <time.h>
庫文件	無
函數功能	獲取當前系統時鐘，從計算機起始時刻到如今所走的秒數。
函數聲明	time_t time ( time_t * timer ); __time32_t _time32 ( __time32_t * timer ); __time64_t _time64 ( __time64_t * timer );
函數參數	_Time，[輸出]：存放從計算機起始時刻到如今所走的秒數的變量的內存指針，不須要就填爲NULL。
返回值	正整數：從計算機起始時刻到如今所走的秒數。 -1：失敗。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數是直接獲取的秒數，不管在哪一個時區都是同樣。若是調用_time32()函數，則當前操做系統的時鐘不能超過協調時的2038年1月19日 03:14:07，不然會返回失敗。若是調用_time64()函數，則當前操做系統的時鐘不能超過協調時的3000年12月31日 23:59:59，不然會返回失敗。 time()函數直接內聯到_time64()函數，若是定義了_USE_32BIT_TIME_T宏，則內聯到_time32()函數。

2.7.4.2 GetSystemTimeAsFileTime

函數名稱	GetSystemTimeAsFileTime
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	獲取當前系統時鐘，並轉換爲文件時間結構體，獲取到的是內存緩存時間，比實際時間大約相差1秒。
函數聲明	VOID GetSystemTimeAsFileTime ( LPFILETIME lpSystemTimeAsFileTime );
函數參數	lpSystemTimeAsFileTime，[輸出]：存放當前系統時間的文件時間結構體的內存指針。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.7.4.3 GetTickcount(未完成)

函數名稱	GetTickcount
頭文件	#include <Winbase.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	獲取從操做系統啓動到如今走了多少毫秒，當關機、重啓、達到最大值4294967295（約49.71天）後，該值會自動清0。
函數聲明	DWORD GetTickCount ( void );
函數參數	無
返回值	從操做系統啓動到如今走了多少毫秒
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數獲取的時長不是實時變化的，而是由操做系統每隔10ms至16ms更新一次。若是擔憂達到最大值後清0，能夠使用GetTickCount64()函數。

2.7.4.4 GetTickcount64(未完成)

函數名稱	GetTickcount64
頭文件	#include <Winbase.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	獲取從操做系統啓動到如今走了多少毫秒，當關機、重啓、達到最大值18446744073709551616（約213503982334.6天）後，該值會自動清0。
函數聲明	ULONGLONG GetTickCount ( void );
函數參數	無
返回值	從操做系統啓動到如今走了多少毫秒
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數獲取的時長不是實時變化的，而是由操做系統每隔10ms至16ms更新一次。

2.7.5 設置時鐘

2.7.5.1 settimeofday

函數名稱	settimeofday
頭文件	#include <time.h>
函數功能	設置當前操做系統的時鐘和時區。
函數聲明	int settimeofday (const struct timeval * tv, const struct timezone * tz);
函數參數	tv，[輸入]：將當前操做系統的時鐘要設置的時間，從1970年1月1日00:00:00到要設置的時間一共走了多少秒，爲NULL表示不設置。 tz，[輸入]：要設置當前操做系統的時區信息，爲NULL表示不設置。
返回值	0：成功。 -1：失敗，並設置errno錯誤碼變量。
線程安全	是
其餘說明	調用此函數須要進程具備root權限。

2.7.6 時鐘轉換

2.7.6.1 localtime_s

函數名稱	localtime_s
頭文件	#include <time.h>
庫文件	無
函數功能	把從本地時的計算機起始時刻到如今所走的秒數轉換成日曆，並存放到指定的日曆結構體。
函數聲明	errno_t localtime_s ( struct tm * _Tm, const time_t * _Time );
函數參數	_Tm，[輸出]：存放轉換後的日曆結構體的內存指針，不能爲NULL。
函數參數	_Time，[輸入]：存放秒數變量的內存指針，本地時的計算機起始時刻到如今所走的秒數，不能爲NULL。
返回值	0：成功。 EINVAL宏：失敗，日曆結構體的內存指針或秒數變量的內存指針是無效的。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數是轉換成本地時的，轉換成協調時用gmtime_s()函數。

2.7.6.2 gmtime_s

函數名稱	gmtime_s
頭文件	#include <time.h>
庫文件	無
函數功能	把從協調時的計算機起始時刻到如今所走的秒數轉換成日曆，並存放到指定的日曆結構體。
函數聲明	errno_t gmtime_s ( struct tm * _tm, const __time_t * time );
函數參數	_tm，[輸出]：存放轉換後日歷結構體的內存指針，不能爲NULL。
函數參數	time，[輸入]：存放秒數變量的內存指針，協調時的計算機起始時刻到如今所走的秒數，不能爲NULL。
返回值	0：成功。 EINVAL宏：失敗，日曆結構體的內存指針或秒數變量的內存指針是無效的。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數是轉換成協調時的，轉換成本地時用localtime_s()函數。

2.7.6.3 mktime

函數名稱	mktime
頭文件	#include <time.h>
庫文件	無
函數功能	把本地時的日曆結構體轉換爲從計算機起始時刻到日曆結構體描述的那一時刻所走的秒數。
函數聲明	time_t mktime ( struct tm * timeptr ); __time32_t _mktime32 ( struct tm * timeptr ); __time64_t _mktime64 ( struct tm * timeptr );
函數參數	timeptr，[輸入]：存放本地時日曆結構體的內存指針，只根據日曆結構體的tm_sec、tm_min、tm_hour、tm_mday、tm_mon成員變量轉換，不能爲NULL。
返回值	-1：失敗，調用errno變量查看錯誤碼。其餘：所走的秒數。
錯誤碼	EINVAL宏：日曆結構體的內存指針是無效的，或者要轉換的日曆超過了範圍。
線程安全	是
原子操做	是
其餘說明	本函數是根據本地時的日曆轉換的。若是調用_mktime32()函數，則日曆不能超過UTC時間2038年1月19日 03:14:0七、CST時間2038年1月19日 11:14:07，不然會返回失敗。若是調用_mktime64()函數，則日曆不能超過UTC時間3000年12月31日 23:59:5九、CST時間3001年1月1日 7:59:59，不然會返回失敗。 mktime()函數直接內聯到_mktime64()函數，若是定義了_USE_32BIT_TIME_T宏，則內聯到_mktime32()函數。

2.8 信號

2.8.1 signal(未完成)

函數名稱	signal
頭文件	#include < signal.h>
函數功能	對指定的信號設置捕捉函數，只會捕捉一次該信號。
函數聲明	sighandler_t signal ( int signum, sighandler_t handler );
函數參數	signum，[輸入]：要捕捉的信號，能夠是（選一至一個）： SIGINT：interrupt(Ctrl+C中斷) SIGILL：illegal instruction - invalid function image(非法指令) SIGFPE：floating point exception(浮點異常) SIGSEGV：segment violation(段錯誤) SIGTERM：Software termination signal from kill(Kill發出的軟件終止) SIGBREAK：Ctrl-Break sequence(Ctrl+Break中斷) SIGABRT：abnormal termination triggered by abort call(Abort) handler，[輸入]：本參數能夠是信號捕捉函數的指針，信號捕捉函數聲明必須是void sighandler (int signum)，信號捕捉函數第一個參數表示捕捉到的信號碼，信號捕捉函數只會捕捉一次該信號，若是須要屢次捕捉，能夠考慮在信號捕捉函數裏再次設置指定信號的捕捉函數；本參數也能夠是（選一至一個）： SIG_DFL：此信號交由系統缺省捕捉處理，本進程再也不捕捉。 SIG_IGN：忽略掉該信號而不作任何處理。
返回值	handler參數：成功。 SIG_ERR：失敗，並設置errno。
錯誤碼	EINVAL：參數錯誤。
線程安全	是
原子操做	是
其餘說明	SIGKILL和SIGSTOP信號沒法被阻塞、捕捉或忽略的。 SIGSEGV和SIGABRT信號捕捉函數是在主線程中執行的，執行時會中斷主線程的執行，不會中斷進程其餘線程的執行，執行完後主線程又回到以前中斷的位置繼續執行。可是全部的SIGSEGV和SIGABRT信號捕捉函數都是在主線程中執行，若是信號捕捉函數在執行時，進程再次捕捉到SIGSEGV或SIGABRT信號，則當即暫停當前執行的信號捕捉函數，開始執行剛剛捕捉到的信號對應的信號捕捉函數，執行完後再回到以前被暫停的信號捕捉函數繼續執行。若是進程再次捕捉到信號，以此類推。若是被暫停的信號捕捉函數很是多的時候，可能會致使堆棧溢出。 SIGINT和SIGBREAK信號捕捉函數是在新的線程中執行的，執行時不會中斷進程其餘線程的執行。可是全部的SIGINT和SIGBREAK信號捕捉函數都是在同一個線程中執行，若是信號捕捉函數在執行時，進程再次捕捉到SIGINT或SIGBREAK信號，則當即暫停當前執行的信號捕捉函數，開始執行剛剛捕捉到的信號對應的信號捕捉函數，執行完後再回到以前被暫停的信號捕捉函數繼續執行。若是進程再次捕捉到信號，以此類推。若是被暫停的信號捕捉函數很是多的時候，可能會形成堆棧溢出。 Windows下不存在信號打斷的問題。

2.9 套接字

2.9.1 WSAStartup(未完成)

函數名稱	WSAStartup
頭文件	#include <Ws2tcpip.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.9.2 socket(未完成)

函數名稱	socket
頭文件	#include <Ws2tcpip.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	建立一個套接字句柄。
函數聲明	SOCKET socket ( int af, int type, int protocol );
函數參數	af，[輸入]：存放套接字使用的地址族的值，能夠爲（選一至一個）： AF_UNSPEC宏(0x0000)：不指定ADDRESS FAMILY地址族，根據protocol協議參數肯定地址族。 AF_INET宏(0x0002)：IPv4地址族。 AF_IPX宏(0x0006)：IPX/SPX地址族，要求系統必須安裝了NWLink IPX/SPX NetBIOS兼容傳輸協議。Windows Vista及之後的系統都不支持本地址族。 AF_APPLETALK宏(0x0010)：AppleTalk地址族，要求系統必須安裝了AppleTalk協議。Windows Vista及之後的系統都不支持本地址族。 AF_NETBIOS宏(0x0011)：NETBIOS地址族，要求系統必須安裝了Windows Sockets provider for NetBIOS。Windows Sockets provider for NetBIOS僅支持32位系統，且32位系統被默認裝上。Windows Sockets provider for NetBIOS不支持64位系統（包括Windows 七、Windows Server 200八、Windows Vista、Windows Server 200三、Windows XP）。使用本地址族的套接字協議必須爲SOCK_DGRAM。Windows Sockets provider for NetBIOS沒有直接關聯到NetBIOS編程接口。NetBIOS編程接口在Windows Vista、Windows Server 2008及之後的系統都不支持。 AF_INET6宏(0x0017)：IPv6地址族。 AF_IRDA宏(0x001A)：紅外數據組織（IrDA）地址族，要求操做系統必須安裝了紅外端口和驅動程序。 AF_BTH宏(0x0020)：藍牙地址族，要求操做系統必須安裝了藍牙適配器和驅動程序。Windows XP SP2及之後的系統才支持本地址族。
	type，[輸入]：存放套接字使用的類型的值，能夠爲（選一至一個）： SOCK_STREAM宏(0x0001)：提供有序的、可靠的、雙向的、基於鏈接、並有帶外數據的字節流傳送機制，af地址族參數必須是AF_INET或AF_INET6，protocol協議參數必須是IPPROTO_TCP。 SOCK_DGRAM宏(0x0002)：支持無鏈接的、不可靠的和使用固定大小(一般很小)緩衝區的數據報傳送機制，af地址族參數必須是AF_INET或AF_INET6，protocol協議參數必須是IPPROTO_UDP。 SOCK_RAW宏(0x0003)：A socket type that provides a raw socket that allows an application to manipulate the next upper-layer protocol header. To manipulate the IPv4 header, the IP_HDRINCL socket option must be set on the socket. To manipulate the IPv6 header, the IPV6_HDRINCL socket option must be set on the socket. SOCK_RDM宏(0x0004)：A socket type that provides a reliable message datagram. An example of this type is the Pragmatic General Multicast (PGM) multicast protocol implementation in Windows, often referred to as reliable multicast programming. This type value is only supported if the Reliable Multicast Protocol is installed. SOCK_SEQPACKET宏(0x0005)：A socket type that provides a pseudo-stream packet based on datagrams.
	protocol，[輸入]：存放套接字使用的協議的值，能夠爲（選一至一個）： IPPROTO_ICMP宏(0x0001)：ICMP(Internet Control Message Protocol)網絡控制消息協議。af地址族參數必須是AF_UNSPEC或AF_INET或AF_INET6，type類型參數必須是SOCK_RAW。Windows XP及之後的系統才支持本協議。 IPPROTO_IGMP宏(0x0002)：IGMP(Internet Group Management Protocol)網絡組管理協議。af地址族參數必須是AF_UNSPEC或AF_INET或AF_INET6，type類型參數必須是SOCK_RAW。Windows XP及之後的系統才支持本協議。 BTHPROTO_RFCOMM宏(0x0003)：Bluetooth RFCOMM(Bluetooth Radio Frequency Communications)藍牙射頻通訊協議。af地址族參數必須是AF_BTH，type類型參數必須是SOCK_STREAM。Windows XP SP2及之後的系統才支持本協議。 IPPROTO_TCP宏(0x0006)：TCP(Transmission Control Protocol)傳輸控制協議。af地址族參數必須是AF_INET或AF_INET6，type類型參數必須是SOCK_STREAM。 IPPROTO_UDP宏(0x0011)：UDP(User Datagram Protocol)用戶數據報協議。af地址族參數必須是AF_INET或AF_INET6，type類型參數必須是SOCK_DGRAM。 IPPROTO_ICMPV6宏(0x003A)：ICMPv6(Internet Control Message Protocol Version 6)網絡控制消息協議版本6。af地址族參數必須是AF_UNSPEC或AF_INET或AF_INET6，type類型參數必須是SOCK_RAW。Windows XP及之後的系統才支持本協議。 IPPROTO_PGM宏(0x0071)：PGM(Pragmatic General Multicast Protocol)實際通用多播協議。af地址族參數必須是AF_INET，type類型參數必須是SOCK_RDM。系統須要先安裝本協議才支持。
返回值	INVALID_SOCKET宏(-0x0001)：失敗，調用WSAGetLastError()函數查看錯誤碼。其餘：成功，返回值就是套接字句柄。
錯誤碼	WSANOTINITIALISED：必須在調用WSAStartup()函數成功後才能調用本函數。 WSAENETDOWN：The network subsystem or the associated service provider has failed. WSAEAFNOSUPPORT：The specified address family is not supported. For example, an application tried to create a socket for the AF_IRDA address family but an infrared adapter and device driver is not installed on the local computer. WSAEINPROGRESS：A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function. WSAEMFILE：No more socket descriptors are available. WSAEINVAL：An invalid argument was supplied. This error is returned if the af parameter is set to AF_UNSPEC and the type and protocol parameter are unspecified. WSAENOBUFS：No buffer space is available. The socket cannot be created. WSAEPROTONOSUPPORT：The specified protocol is not supported. WSAEPROTOTYPE：The specified protocol is the wrong type for this socket. WSAEPROVIDERFAILEDINIT：The service provider failed to initialize. This error is returned if a layered service provider (LSP) or namespace provider was improperly installed or the provider fails to operate correctly. WSAESOCKTNOSUPPORT：The specified socket type is not supported in this address family. WSAINVALIDPROVIDER：The service provider returned a version other than 2.2. WSAINVALIDPROCTABLE：The service provider returned an invalid or incomplete procedure table to the WSPStartup.
線程安全	是
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.9.3 accept(未完成)

函數名稱	accept
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.9.4 connect(未完成)

函數名稱	connect
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.9.5 recv(未完成)

函數名稱	recv
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	接收套接字的遠端發送過來的數據。
函數聲明	int recv( SOCKET s, char * buf, int len, int flags );
函數參數	s，[輸入]：存放套接字句柄的值。
	buf，[輸出]：存放接收遠端發來的數據的內存指針。
	len，[輸出]：存放接收遠端發來的數據的內存長度，單位字節。
	flags，[輸出]：存放其餘功能標記的值，能夠是（用'\|'選零至多個）： MSG_PEEK(0x0002)：若是設置本標記，表示預讀接收到的數據。將遠端發來的數據複製到buf參數中，但不會將遠端發來的數據從接收緩存區中刪除。若是不設置本標記，表示取出接收到的數據。將遠端發來的數據複製到buf參數中，並從接收緩存區中刪除。 MSG_OOB(0x0001)：若是設置本標記，表示處理OOB帶外數據。若是不設置本標記，表示不處理OOB帶外數據。 MSG_WAITALL(0x0008)：若是設置本標記，表示本函數僅當如下事件發生時才返回： 1) buf參數已經被徹底填滿。 2) 鏈接已經關閉。 3) 接收數據的請求已經取消，或有錯誤發生。注意：若是操做系統不支持本標記、或套接字爲非阻塞模式，則不能設置本標記，不然報WSAEOPNOTSUPP錯誤。Also, if MSG_WAITALL is specified along with MSG_OOB, MSG_PEEK, or MSG_PARTIAL, then this call will fail with WSAEOPNOTSUPP. This flag is not supported on datagram sockets or message-oriented sockets. 若是不設置本標記，阻塞模式下，表示本函數一旦接收到了數據就返回，非阻塞模式下，有沒有接收到數據都返回。
返回值	0：失敗，緣由爲套接字已正常關閉。 SOCKET_ERROR(-0x0001)：失敗，調用WSAGetLastError()查看錯誤碼。其餘：接收到的數據的長度。
錯誤碼	WSANOTINITIALISED(0x276D)：應用程序沒有調用WSAStartup()函數，或者WSAStartup()函數失敗，所以必須在調用WSAStartup()函數成功後才能調用本函數。 WSAENETDOWN：The network subsystem has failed. WSAEFAULT：The buf parameter is not completely contained in a valid part of the user address space. WSAENOTCONN：The socket is not connected. WSAEINTR：The (blocking) call was canceled through WSACancelBlockingCall. WSAEINPROGRESS：A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function. WSAENETRESET：For a connection-oriented socket, this error indicates that the connection has been broken due to keep-alive activity that detected a failure while the operation was in progress. For a datagram socket, this error indicates that the time to live has expired. WSAENOTSOCK：The descriptor is not a socket. WSAEOPNOTSUPP(0x273D)：參考的對象類型不支持嘗試的操做。MSG_OOB was specified, but the socket is not stream-style such as type SOCK_STREAM, OOB data is not supported in the communication domain associated with this socket, or the socket is unidirectional and supports only send operations. WSAESHUTDOWN：The socket has been shut down; it is not possible to receive on a socket after shutdown has been invoked with how set to SD_RECEIVE or SD_BOTH. WSAEWOULDBLOCK：The socket is marked as nonblocking and the receive operation would block. WSAEMSGSIZE：The message was too large to fit into the specified buffer and was truncated. WSAEINVAL：The socket has not been bound with bind, or an unknown flag was specified, or MSG_OOB was specified for a socket with SO_OOBINLINE enabled or (for byte stream sockets only) len was zero or negative. WSAECONNABORTED：The virtual circuit was terminated due to a time-out or other failure. The application should close the socket as it is no longer usable. WSAETIMEDOUT：The connection has been dropped because of a network failure or because the peer system failed to respond. WSAECONNRESET：The virtual circuit was reset by the remote side executing a hard or abortive close. The application should close the socket as it is no longer usable. On a UDP-datagram socket, this error would indicate that a previous send operation resulted in an ICMP "Port Unreachable" message.
線程安全	是
原子操做	是
其餘說明	本函數工做原理：一、若是是阻塞模式的TCP套接字： 1) 若是接收緩存區中有數據，本函數就會將接收緩存區中數據一次性儘量多的讀取出來，而後就返回成功。 2) 若是接收緩存區中沒有數據，本函數就會一直等待到有數據，一次性儘量多的讀取出來，而後就返回成功。 3) 若是接收緩存區的長度爲0，就將所有要發送的數據直接傳給操做系統，等待操做系統處理完，而後就返回成功。 4) 發送緩存區的長度爲0時，阻塞時間將明顯增加，比發送緩存區的長度爲1時要長不少。這麼作能夠提高發送數據的實時性，但會下降效率。二、若是是非阻塞模式的TCP套接字： 1) 若是發送緩存區可以容納要發送的數據，本函數就會將要發送的數據一次性寫入到發送緩存區，而後就返回成功。 2) 若是發送緩存區不夠容納要發送的數據，本函數就會先將一部分要發送的數據寫入到發送緩存區，而後等待操做系統將發送緩存區中的數據取走，再將剩餘的要發送的數據寫入到發送緩存區，以此類推，直到將所有要發送的數據寫入到發送緩存區，而後就返回成功。可是，若是本函數發現不能在很短的時間內將所有要發送的數據寫入到發送緩存區，就不會寫入任何數據，而後就返回失敗，並報WSAEWOULDBLOCK錯誤。 3) 若是發送緩存區的長度爲0，就將所有要發送的數據直接傳給操做系統，等待操做系統處理完，而後就返回成功。 4) 發送緩存區的長度爲0時，非阻塞模式的TCP套接字也將阻塞，不會報WSAEWOULDBLOCK錯誤。這麼作能夠提高發送數據的實時性，但會下降效率。

2.9.6 send(未完成)

函數名稱	send
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	使用已鏈接的套接字發送數據給遠端。
函數聲明	int send ( SOCKET s, const char * buf, int len, int flags );
函數參數	s，[輸入]：存放套接字句柄的值。
	buf，[輸入]：存放要發送的數據的內存指針。
	len，[輸入]：存放要發送的數據的內存長度，單位字節。
	flags，[輸入]：存放發送數據時的標記，能夠是（用'\|'選零至多個）： MSG_DONTROUTE：Specifies that the data should not be subject to routing. A Windows Sockets service provider can choose to ignore this flag. MSG_OOB：Sends OOB data (stream-style socket such as SOCK_STREAM only.
返回值	SOCKET_ERROR(-0x0001)：失敗，調用WSAGetLastError()函數查看錯誤碼。其餘：已成功發送的數據的長度，單位字節，通常和len參數相同，也可能比len參數小。
錯誤碼	WSANOTINITIALISED(0x276D)：應用程序沒有調用WSAStartup()函數，或者WSAStartup()函數失敗，所以必須在調用WSAStartup()函數成功後才能調用本函數。 WSAENETDOWN(0x2742)：套接字操做遇到了一個已死的網絡。 WSAEACCES(0x271D)：以一種訪問權限不容許的方式作了一個訪問套接字的嘗試。The requested address is a broadcast address, but the appropriate flag was not set. Call setsockopt with the SO_BROADCAST socket option to enable use of the broadcast address. WSAEINTR(0x2714)：一個封鎖操做被對WSACancelBlockingCall()函數的調用中斷。A blocking Windows Sockets 1.1 call was canceled through WSACancelBlockingCall. WSAEINPROGRESS(0x2734)：目前正在執行一個阻止性操做。A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function. WSAEFAULT(0x271E)：系統檢測到在一個調用中嘗試使用指針參數時的無效指針地址。The buf parameter is not completely contained in a valid part of the user address space. WSAENETRESET(0x2744)：當該操做在進行中，因爲保持活動的操做檢測到一個故障，該鏈接中斷。The connection has been broken due to the keep-alive activity detecting a failure while the operation was in progress. WSAENOBUFS(0x2747)：因爲系統緩衝區空間不足或隊列已滿，不能執行套接字上的操做。No buffer space is available. WSAENOTCONN(0x2749)：因爲套接字沒有鏈接而且(當使用一個 sendto 調用發送數據報套接字時)沒有提供地址，發送或接收數據的請求沒有被接受。The socket is not connected. WSAENOTSOCK(0x2736)：在一個非套接字上嘗試了一個操做。The descriptor is not a socket. WSAEOPNOTSUPP(0x273D)：參考的對象類型不支持嘗試的操做。MSG_OOB was specified, but the socket is not stream-style such as type SOCK_STREAM, OOB data is not supported in the communication domain associated with this socket, or the socket is unidirectional and supports only receive operations. WSAESHUTDOWN(0x274A)：因爲之前的關閉調用，套接字在那個方向已經關閉，發送或接收數據的請求沒有被接受。The socket has been shut down; it is not possible to send on a socket after shutdown has been invoked with how set to SD_SEND or SD_BOTH. WSAEWOULDBLOCK(0x2733)：沒法當即完成一個非阻止性套接字操做。The socket is marked as nonblocking and the requested operation would block. WSAEMSGSIZE(0x2738)：一個在數據報套接字上發送的消息大於內部消息緩衝區或其餘一些網絡限制，或該用戶用於接收數據報的緩衝區比數據報小。The socket is message oriented, and the message is larger than the maximum supported by the underlying transport. WSAEHOSTUNREACH(0x2751)：套接字操做嘗試一個沒法鏈接的主機。The remote host cannot be reached from this host at this time. WSAEINVAL(0x2726)：提供了一個無效的參數。The socket has not been bound with bind, or an unknown flag was specified, or MSG_OOB was specified for a socket with SO_OOBINLINE enabled. WSAECONNABORTED(0x2745)：你的主機中的軟件停止了一個已創建的鏈接。The virtual circuit was terminated due to a time-out or other failure. The application should close the socket as it is no longer usable. WSAECONNRESET(0x2746)：遠程主機強迫關閉了一個現有的鏈接。The virtual circuit was reset by the remote side executing a hard or abortive close. For UDP sockets, the remote host was unable to deliver a previously sent UDP datagram and responded with a "Port Unreachable" ICMP packet. The application should close the socket as it is no longer usable. WSAETIMEDOUT(0x274C)：因爲鏈接方在一段時間後沒有正確答覆或鏈接的主機沒有反應，鏈接嘗試失敗。The connection has been dropped, because of a network failure or because the system on the other end went down without notice.
線程安全	是
原子操做	是
其餘說明	本函數返回成功並不表明遠端已經接收到數據，若是想保證對方能收到，建議讓遠端收到後給回執。本函數工做原理：一、若是是阻塞模式的TCP套接字： 1) 若是發送緩存區可以容納要發送的數據，本函數就會將要發送的數據一次性寫入到發送緩存區，而後就返回成功。 2) 若是發送緩存區不夠容納要發送的數據，本函數就會先將一部分要發送的數據寫入到發送緩存區，而後等待操做系統將發送緩存區中的數據取走，再將剩餘的要發送的數據寫入到發送緩存區，以此類推，直到將所有要發送的數據寫入到發送緩存區，而後就返回成功。若是發送數據的超時時間已到，也會當即返回，返回值爲已發送的數據長度。 3) 若是發送緩存區的長度爲0，就將所有要發送的數據直接傳給操做系統，等待操做系統處理完，而後就返回成功。若是發送數據的超時時間已到，也會當即返回，返回值爲已發送的數據長度。 4) 發送緩存區的長度爲0時，阻塞時間將明顯增加，比發送緩存區的長度爲1時要長不少。這麼作能夠提高發送數據的實時性，但會下降效率。二、若是是非阻塞模式的TCP套接字： 1) 若是發送緩存區可以容納要發送的數據，本函數就會將要發送的數據一次性寫入到發送緩存區，而後就返回成功。 2) 若是發送緩存區不夠容納要發送的數據，本函數就會先將一部分要發送的數據寫入到發送緩存區，而後等待操做系統將發送緩存區中的數據取走，再將剩餘的要發送的數據寫入到發送緩存區，以此類推，直到將所有要發送的數據寫入到發送緩存區，而後就返回成功。可是，若是本函數發現不能在很短的時間內將所有要發送的數據寫入到發送緩存區，就不會寫入任何數據，而後就返回失敗，並報WSAEWOULDBLOCK錯誤。 3) 若是發送緩存區的長度爲0，就將所有要發送的數據直接傳給操做系統，等待操做系統處理完，而後就返回成功。 4) 發送緩存區的長度爲0時，非阻塞模式的TCP套接字也將阻塞，不會報WSAEWOULDBLOCK錯誤。這麼作能夠提高發送數據的實時性，但會下降效率。

2.9.7 getaddrinfo(未完成)

函數名稱	getaddrinfo
頭文件	#include <Ws2tcpip.h> #pragma comment(lib, "Ws2_32.lib")
函數功能	根據指定的主機名和服務名或端口號獲取多個地址信息。
函數聲明	INT getaddrinfo ( PCSTR pNodeName, PCSTR pServiceName, const ADDRINFOA * pHints, PADDRINFOA * ppResult );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	0：成功。非0：Windows套接字錯誤碼，也可調用WSAGetLastError()查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

函數功能：

函數聲明：int getaddrinfo (const char * node,

const char * service,

const struct addrinfo * hints,

struct addrinfo ** res);

函數參數：參數1：參數說明。

參數2：參數說明。

……

返回值：0：成功。

EAI_ADDRFAMILY：The specified network host does not have any network addresses in the requested address family.

EAI_AGAIN：The name server returned a temporary failure indication. Try again later.

EAI_BADFLAGS：ai_flags contains invalid flags.

EAI_FAIL：The name server returned a permanent failure indication.

EAI_FAMILY：The requested address family is not supported at all.

EAI_MEMORY：Out of memory.

EAI_NODATA：The specified network host exists, but does not have any network addresses defined.

EAI_NONAME：The node or service is not known; or both node and service are NULL; or AI_NUMERICSERV was specified in hints.ai_flags and service was not a numeric port-number string.

EAI_SERVICE：The requested service is not available for the requested socket type. It may be available through another socket type.

EAI_SOCKTYPE：The requested socket type is not supported at all.

EAI_SYSTEM：Other system error, check errno for details.

線程安全：是

注意事項：

……

2.9.8 getnameinfo(未完成)

頭文件：#include <sys/socket.h>

#include <netdb.h>

函數名稱：getnameinfo

函數功能：函數主要功能說明。

函數聲明：int getnameinfo (const struct sockaddr * sa,

socklen_t salen,

char *host,

size_t hostlen,

char *serv,

size_t servlen,

int flags);

函數參數：

返回值：0：成功。

EAI_AGAIN：The name could not be resolved at this time. Try again later.

EAI_BADFLAGS：The flags argument has an invalid value.

EAI_FAIL：A nonrecoverable error occurred.

EAI_FAMILY：The address family was not recognized, or the address length was invalid for the specified family.

EAI_MEMORY：Out of memory.

EAI_NONAME：The name does not resolve for the supplied arguments. NI_NAMEREQD is set and the host's name cannot be located, or neither hostname nor service name were requested.

EAI_OVERFLOW：The buffer pointed to by host or serv was too small.

EAI_SYSTEM：A system error occurred. The error code can be found in errno.

線程安全：是

注意事項：

2.9.9 getifaddrs(未完成)

頭文件：#include <sys/types.h>

#include <ifaddrs.h>

函數名稱：getifaddrs

函數功能：獲取網絡設備的IP地址。

函數聲明：int getifaddrs (struct ifaddrs ** ifap);

函數參數：0：成功。

-1：失敗，並設置errno錯誤碼變量。

返回值：返回值1：返回值說明。

返回值2：返回值說明。

……

線程安全：是或否或未知

注意事項：

struct ifaddrs

{

struct ifaddrs * ifa_next; //指向鏈表的下一個成員

char * ifa_name; //網絡設備名字符串

unsigned int ifa_flags; //Flags from SIOCGIFFLAGS

struct sockaddr * ifa_addr; //Address of interface

struct sockaddr * ifa_netmask; //Netmask of interface

union

{

struct sockaddr * ifu_broadaddr; // Broadcast address of interface

struct sockaddr * ifu_dstaddr; // Point-to-point destination address

}ifa_ifu;

#define ifa_broadaddr ifa_ifu.ifu_broadaddr

#define ifa_dstaddr ifa_ifu.ifu_dstaddr

void * ifa_data; // Address-specific data

};

ifa_next指向鏈表的下一個成員；ifa_name是接口名稱，以0結尾的字符串，好比eth0，lo；ifa_flags是接口的標識位（好比當IFF_BROADCAST或IFF_POINTOPOINT設置到此標識位時，影響聯合體變量ifu_broadaddr存儲廣播地址或ifu_dstaddr記錄點對點地址）；ifa_netmask存儲該接口的子網掩碼；結構體變量存儲廣播地址或點對點地址（見括弧介紹ifa_flags）；ifa_data存儲了該接口協議族的特殊信息，它一般是NULL（通常不關注他）。

使用完後，必須使用freeifaddrs()函數釋放內存。

2.9.10 select(未完成)

函數名稱	select
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	阻塞檢查一個或多個套接字是否處於可讀狀態、可寫狀態、異常狀態。
函數聲明	int select ( int nfds, fd_set * readfds, fd_set * writefds, fd_set * exceptfds, const struct timeval * timeout );
函數參數	nfds，[輸入]：本參數無心義，只是爲了兼容伯克利套接字。
	readfds，[輸入]：存放須要檢查是否處於可讀狀態的套接字集，若是爲NULL，表示不檢查可讀狀態。可讀狀態分爲：若是TCP服務端套接字處於監聽狀態，表示能夠接受TCP鏈接請求，若是調用accept()函數會當即返回。表示套接字能夠接收數據，包括帶外數據（若是打開SO_OOBINLINE選項），能夠調用recv()、WSARecv()、WSARecvFrom()、recvfrom()函數接收到數據。表示已經鏈接的TCP套接字已經被關閉、重置、或終止，若是調用recv()、WSARecv()、WSARecvFrom()、recvfrom()函數會當即返回。
	writefds，[輸入]：存放須要檢查是否處於可寫狀態的套接字集，若是爲NULL，表示不檢查可寫狀態。可寫狀態分爲：若是套接字處於正在鏈接中（非阻塞套接字調用connect()函數後），表示鏈接成功，並能夠調用send()、sendto()函數發送出數據。表示套接字能夠發送數據，能夠調用send()、sendto()函數發送出數據。
	exceptfds，[輸入]：存放須要檢查是否處於異常狀態的套接字集，若是爲NULL，表示不檢查異常狀態。異常狀態分爲：表示套接字能夠接收帶外數據（若是關閉SO_OOBINLINE選項）。若是套接字處於正在鏈接中（非阻塞套接字調用connect()函數後），表示鏈接失敗。表示已經鏈接的TCP套接字已經被關閉、重置、或終止。
	timeout，[輸入]：存放阻塞檢查的超時時間。若是爲0秒0毫秒，表示不阻塞當即完成。若是爲NULL，表示不限制超時時間。
返回值	SOCKET_ERROR宏(-0x0001)：失敗，並清空全部套接字集，調用WSAGetLastError()函數查看錯誤碼。 0：成功，不清空任何套接字集，但在阻塞檢查的超時時間內沒有任何套接字處於須要檢查的狀態。大於0：成功，三個套接字集一共有多少個套接字處於須要檢查的狀態，並把每一個套接字集中不處於須要檢查的狀態的套接字刪除掉，只保留處於須要檢查的狀態的套接字，調用FD_ISSET()宏函數判斷。
錯誤碼	WSANOTINITIALISED：必須在調用WSAStartup()函數成功後才能調用本函數。 WSAEFAULT：The Windows Sockets implementation was unable to allocate needed resources for its internal operations, or the readfds, writefds, exceptfds, or timeval parameters are not part of the user address space. WSAENETDOWN：The network subsystem has failed. WSAEINVAL：The time-out value is not valid, or all three descriptor parameters were null. WSAEINTR：A blocking Windows Socket 1.1 call was canceled through WSACancelBlockingCall. WSAEINPROGRESS：A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function. WSAENOTSOCK：One of the descriptor sets contains an entry that is not a socket.
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	套接字集使用方法： FD_SETSIZE宏：定義一個套接字集結構體變量最多容納多少個套接字，默認爲64，若是須要修改本宏，應在定義套接字集結構體變量前修改。 fd_set stFdset;：定義套接字集結構體變量。 *FD_ZERO (fd_set fdset) 宏函數：清空fdset套接字集內的全部套接字。 FD_SET (int fd, fd_set * fdset) 宏函數：向fdset套接字集內添加一個fd套接字。 FD_CLR (int fd, fd_set * fdset) 宏函數：從fdset套接字集內刪除一個fd套接字。 FD_ISSET (int fd, fd_set * fdset) 宏函數**：判斷fdset套接字集內是否存在fd套接字，返回值爲非0表示存在，爲0表示不存在。

2.9.11 getsockopt(未完成)

函數名稱	getsockopt
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	獲取指定的套接字選項的值。
函數聲明	int getsockopt( SOCKET s, int level, int optname, char FAR * optval, int FAR * optlen );
函數參數	s，[輸入]：存放套接字句柄。
	level，[輸入]：存放套接字選項的等級。
	optname，[輸入]：存放套接字選項的名稱。
	optval，[輸出]：存放獲取到的套接字選項的值的變量的內存指針。
	optlen，[輸入&輸出]：輸入時，存放獲取到的套接字選項的值的變量的內存長度的變量的內存指針。輸出時，存放實際獲取到的套接字選項的值的變量的內存長度。
返回值	0：成功。 SOCKET_ERROR：失敗，調用WSAGetLastError()函數查看錯誤碼。
錯誤碼	WSANOTINITIALISED：應用程序沒有調用WSAStartup()函數，或者WSAStartup()函數失敗，所以必須在調用WSAStartup()函數成功後才能調用本函數。 WSAENETDOWN：Note The network subsystem has failed. WSAEFAULT：One of the optval or the optlen parameters is not a valid part of the user address space, or the optlen parameter is too small. WSAEINPROGRESS：A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function. WSAEINVAL：套接字選項的等級是未知的或無效的。 WSAENOPROTOOPT：在指定的套接字選項在套接字選項的等級中是未知的或不支持的。 WSAENOTSOCK：指定的不是一個套接字句柄。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.9.12 WSAGetLastError(未完成)

函數名稱	WSAGetLastError
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	獲取當前線程最近一次Winsock套接字操做的錯誤碼。
函數聲明	int WSAGetLastError( void );
函數參數	無
返回值	當前線程最近一次Winsock套接字操做的錯誤碼。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.9.13 WSASetLastError(未完成)

函數名稱	WSASetLastError
頭文件	#include <Winsock2.h>
庫文件	#pragma comment(lib, "Ws2_32.lib")
函數功能	設置當前線程最近一次Winsock套接字操做的錯誤碼。
函數聲明	int WSASetLastError( int iError );
函數參數	iError，[輸入]：存放Winsock套接字操做的錯誤碼。
返回值	無
錯誤碼	WSANOTINITIALISED：應用程序沒有調用WSAStartup()函數，或者WSAStartup()函數失敗，所以必須在調用WSAStartup()函數成功後才能調用本函數。
線程安全	是
原子操做	是
其餘說明	經過本函數設置後，後續的Winsock套接字操做可能會再次修改錯誤碼。

2.10 軟硬件設備

2.10.1 通用

2.10.1.1 DeviceIoControl(未完成)

函數名稱	DeviceIoControl
頭文件	#include <Windows.h>
函數功能	直接發送控制代碼到指定的設備，讓該設備來執行相應的操做。
函數聲明	BOOL DeviceIoControl ( HANDLE hDevice, DWORD dwIoControlCode, LPVOID lpInBuffer, DWORD nInBufferSize, LPVOID lpOutBuffer, DWORD nOutBufferSize, LPDWORD lpBytesReturned, LPOVERLAPPED lpOverlapped );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.10.1.2 NtQuerySystemInformation(未完成)

函數名稱	NtQuerySystemInformation
頭文件	#include <Winternl.h> #include <Ntstatus.h>
庫文件	#pragma comment(lib, "Ntdll.lib")
函數功能	函數主要功能說明。
函數聲明	NTSTATUS NtQuerySystemInformation ( SYSTEM_INFORMATION_CLASS SystemInformationClass, PVOID SystemInformation, ULONG SystemInformationLength, PULONG ReturnLength );
函數參數	SystemInformationClass，[輸入]：存放要獲取什麼類型的系統信息的標記，能夠爲（選一至一個）： SystemBasicInformation枚舉(0)： Returns the number of processors in the system in a SYSTEM_BASIC_INFORMATION structure. Use the GetSystemInfo function instead. SystemPerformanceInformation枚舉(2)： Returns an opaque SYSTEM_PERFORMANCE_INFORMATION structure that can be used to generate an unpredictable seed for a random number generator. Use the CryptGenRandom function instead. SystemTimeOfDayInformation枚舉(3)： Returns an opaque SYSTEM_TIMEOFDAY_INFORMATION structure that can be used to generate an unpredictable seed for a random number generator. Use the CryptGenRandom function instead. SystemProcessInformation枚舉(5)：獲取全部進程的進程信息，並存放到SYSTEM_PROCESS_INFORMATION結構體數組中，用結構體的NextEntryOffset成員變量遍歷數組。進程信息包括進程使用的處理數、峯值頁面文件的使用量以及進程已分配的內存頁的數量等。 SystemProcessorPerformanceInformation枚舉(8)：獲取每一個CPU處理器核心的的當前累計的空閒時間、內核時間、用戶時間，並存放到SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION結構體數組中。用本函數ReturnLength參數返回的長度除以單個SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION結構體的長度，就是SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION結構體數組的元素個數，也就是CPU核心總數。 SystemInterruptInformation枚舉(23)： Returns an opaque SYSTEM_INTERRUPT_INFORMATION structure that can be used to generate an unpredictable seed for a random number generator. Use the CryptGenRandom function instead. SystemExceptionInformation枚舉(33)： Returns an opaque SYSTEM_EXCEPTION_INFORMATION structure that can be used to generate an unpredictable seed for a random number generator. Use the CryptGenRandom function instead. SystemRegistryQuotaInformation枚舉(37)： Returns a SYSTEM_REGISTRY_QUOTA_INFORMATION structure. SystemLookasideInformation枚舉(45)： Returns an opaque SYSTEM_LOOKASIDE_INFORMATION structure that can be used to generate an unpredictable seed for a random number generator. Use the CryptGenRandom function instead. SystemQueryPerformanceCounterInformation枚舉(134)： Returns a SYSTEM_QUERY_PERFORMANCE_COUNTER_INFORMATION structure that can be used to determine whether the system requires a kernel transition to retrieve the high-resolution performance counter information through a QueryPerformanceCounter function call.
	SystemInformation，[輸入&輸出]：參數說明。
	SystemInformationLength，[輸入]：存放指定的信息結構體的內存長度，單位字節。
	ReturnLength，[輸出]：存放寫入了多少字節的數據到指定的信息結構體。若是指定的信息結構體的長度不夠放下實際的數據，則不會寫入任何數據到指定的信息結構體，但本參數仍是會返回須要寫入多少字節的數據。
返回值	大於等於0：成功，返回值就是成功碼。小於0：失敗，返回值就是錯誤碼。
錯誤碼	STATUS_SUCCESS宏(0x0)：成功。 STATUS_INFO_LENGTH_MISMATCH宏(0xC0000004)：指定的信息結構體的長度不夠放下實際的數據。 ……
線程安全	是
原子操做	是
其餘說明

2.10.2 CPU處理器

系統在使用CPU處理器時，分爲幾個模式使用，當沒有任何進程要使用時，系統就讓CPU處理器執行空閒線程，此時CPU處理器就處於空閒狀態，當有進程在用戶模式下執行時，CPU處理器就處於用戶狀態下，當有進程在內核模式下運行時，CPU處理器就處於內核狀態下。

空閒狀態、用戶狀態、內核狀態所佔用的時間，就叫空閒時間、用戶時間、內核時間。

2.10.2.1 GetSystemTimes(未完成)

函數名稱	GetSystemTimes
頭文件	#include <Windows.h>
函數功能	獲取CPU處理器的當前累計的空閒時間、內核時間、用戶時間。
函數聲明	BOOL GetSystemTimes ( LPFILETIME lpIdleTime, LPFILETIME lpKernelTime, LPFILETIME lpUserTime );
函數參數	lpIdleTime，[輸出]：存放當前累計的空閒時間。
	lpKernelTime，[輸出]：存放當前累計的空閒時間與內核時間之和。
	lpUserTime，[輸出]：存放當前累計的用戶時間。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	本函數獲取到的時間都是FILETIME結構體，若是須要浮點型的數值，須要進行轉換。若是要計算CPU處理器的使用率，就是100 - 空閒時間 / (用戶時間 + 空閒時間 + 內核時間) * 100.0。

2.10.3 MEM內存

2.10.3.1 內存概念

2.10.3.1.1 進程的內存

圖一

對於系統中的每個進程而言，都有 4GB 的 "內存空間"。也就是每一個進程都認爲本身有 4GB 的內存能夠使用。

系統將每一個進程的 4GB 地址空間，從邏輯上劃分爲兩大部分：

1) 藍色的用戶空間，此空間是被用戶程序所使用的。好比我在代碼中寫「分配100MB內存」，其實佔用的就是這一部分。

2) 紅色的內核空間，此空間是被用做操做系統執行必要的線程切換以及從用戶態函數進入內核態執行功能所保留的內存地址. 應用程序沒法操做此區域。

2.10.3.1.2 Intel x86 體系內存管理

Intel 規定, 一個在計算機內部, 能夠使用 "分頁機制" 對硬件內存進行 "虛擬化". 其核心技術以下圖:

圖二

首先, 在程序中的一個地址 0x1234, 5678 被計算機的頁部件(硬件)通過 1,2,3 步, 從線性地址(程序中的地址) 轉變爲真正機器上的物理地址(即實際內存的硬件地址). 每一個線性地址都被分紅 "頁目錄索引(PDE, 10-bit)", "頁表索引(PTE, 10-bit)", "頁內偏移(offset, 12-bit)" 三部分.

1) 在頁目錄中根據 PDE 找到頁表的位置, 即經過 0x48 找到 0xa000, 0000.

2) 根據頁表中的 PTE 找到頁地址, 即經過 0x345 找到 0x4000, 0000.

3) 根據偏移, 在頁中找到咱們要的具體地址, 即已知頁位於 0x4000, 0000, 咱們須要存取其 0x678 偏移處的數據, 則咱們所須要操做的真是物理地址就是 0x4000, 0678.

2.10.3.1.3 基於 x86 的 Windows 內存管理

圖 3

首先澄清兩個概念：

　　1. 一個進程中的內存有三種分類, 空閒, 保留, 提交. 具體的含義能夠在 圖 3 中找到說明. 這三種類型的內存在某一時刻可能位於內存中, 也可能位於交換文件中.

　　2. 工做集定義: The working set of a process is the set of pages in the virtual address space of the process that are currently resident in physical memory. 即: 實際在物理內存中的大小.

結合實際系統, 以我家安裝的 win8.1 爲例, 打開任務管理器, 可見以下：

圖 4

工做集(內存): 能夠這麼理解, 此值就是該進程所佔用的總物理內存. 可是這個值是由兩部分組成, 即 '專用工做集' + '共享工做集'.

內存(專用工做集): 這對於一個進程是最重要的, 它表明了一個進程獨佔用了多少內存.

內存(共享工做集): 這是該進程和別的進程共享的內存量. 一般, 這是加載一個 dll 所佔用的內存.

提交大小: 屬於 Committed 那一類. 可是不必定在物理內存中, 有些可能位於交換文件中. 若是有一個程序, 本來佔 500MB 內存, 可是絕大多數內存都不使用, 則能夠經過 `EmptyWorkingSet` 向操做系統發送請求, 將此進程的不經常使用的內容從物理內存中換出到換頁文件中保存, 以下圖：

圖 5

2.10.3.1.4 寫在最後

0. 工做集, 即在物理內存中的數據的集合.

1. 工做集 = 專用 + 共享

2. 將全部的 "工做集" 相加後的值會大於任務管理器中內存佔用的百分比, 由於百分比對共享內存進行排重了.

3. "提交大小" 和 "工做集" 是兩個層面的概念, 大部分活躍進程的 "工做集" 會大於 "提交大小", 而大部分非活躍的進程 "工做集" 會小於 "提交大小", 可是二者沒有絕對關係.

4. 虛擬內存: 就是換頁文件.

2.10.3.2 GlobalMemoryStatus(未完成)

函數名稱	GlobalMemoryStatus
頭文件	#include <Windows.h>
函數功能	獲取系統當前物理內存和虛擬內存的相關信息。
函數聲明	void GlobalMemoryStatus ( LPMEMORYSTATUS lpBuffer );
函數參數	lpBuffer，[輸出]：存放物理內存和虛擬內存的相關信息的結構體的內存指針。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數只能獲取內存大小不超過4GB的相關信息，若是要獲取內存大小超過4GB的相關信息，能夠調用GlobalMemoryStatusEx()函數。

2.10.4 網絡接口和網絡適配器

GetIfEntry() 獲取本機一個指定網絡接口或網絡設備的索引序號的信息。

類型爲PPP協議的寬帶鏈接的網絡適配器，在沒有鏈接時，操做狀態爲已禁用。

2.10.4.1 GetIfTAble(未完成)

函數名稱	GetIfTAble
頭文件	#include <Iphlpapi.h> #pragma comment(lib, "Iphlpapi.lib")
函數功能	獲取本機全部網絡接口和網絡適配器的狀態信息。
函數聲明	DWORD GetIfTable ( PMIB_IFTABLE pIfTable, PULONG pdwSize, BOOL bOrder );
函數參數	pIfTable，[輸出]：存放MIB_IFTABLE結構體數組的內存指針。本參數用於存放本機全部網絡接口和網絡適配器的狀態信息，本參數應該是先由程序調用malloc()等函數分配的內存。
	pdwSize，[輸入&輸出]：輸入時，存放pIfTable參數指定的MIB_IFTABLE結構體數組的內存長度的變量的內存指針，單位字節。輸出時，存放輸出了多少長度的數據到pIfTable參數指定的MIB_IFTABLE結構體數組裏，若是MIB_IFTABLE結構體數組的內存長度不夠，則不會輸出任何數據到MIB_IFTABLE結構體數組裏，但本參數任然會在輸出時存放MIB_IFTABLE結構體數組的內存最小長度。
	bOrder，[輸入]：存放是否須要根據網絡設備的索引序號將MIB_IFTABLE結構體數組裏的狀態信息排序。非0表示排序，0表示不排序。
返回值	ERROR_SUCCESS宏（0）：成功。 ERROR_INSUFFICIENT_BUFFER宏（122）：失敗，MIB_IFTABLE結構體的內存長度不夠，查看pdwSize參數獲取最小長度。 ERROR_INVALID_PARAMETER宏（87）：失敗，錯誤的參數，pdwSize參數爲NULL，或本函數的調用進程沒法讀寫pIfTable參數或pdwSize參數指定的內存。 ERROR_NOT_SUPPORTED宏（50）：失敗，操做系統不受支持。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	本函數通常須要調用兩次，第一次pIfTable參數填NULL，pdwSize參數填的存放內存長度的變量爲0。而後本函數返回後，再根據pdwSize參數存放的內存最小長度分配pIfTable參數指定的內存，最後再調用本函數就能成功。也有可能第二次調用的時候狀況發生了變化，致使分配的內存長度仍是不夠，就須要不停的從新分配內存，直到本函數調用成功爲止。若是是其餘錯誤，則應該報錯跳出循環。

2.10.4.2 GetAdaptersInfo(未完成)

函數名稱	GetAdaptersInfo
頭文件	#include <Iphlpapi.h> #pragma comment(lib, "Iphlpapi.lib")
函數功能	獲取本機全部網絡適配器的配置信息。只獲取已啓用的網絡適配器，不獲取已禁用的網絡適配器。不獲取網絡接口、迴環網絡適配器。
函數聲明	DWORD GetAdaptersInfo ( PIP_ADAPTER_INFO pIfTable, PULONG dwOutBufLen );
函數參數	pIfTable，[輸出]：存放IP_ADAPTER_INFO結構體鏈表的內存指針。本參數用於存放本機全部網絡適配器的配置信息，本參數應該是先由程序調用malloc()等函數分配的內存。
函數參數	dwOutBufLen，[輸入&輸出]：輸入時，存放pIfTable參數指定的IP_ADAPTER_INFO結構體鏈表的內存長度的變量的內存指針，單位字節。輸出時，存放輸出了多少長度的數據到pIfTable參數指定的IP_ADAPTER_INFO結構體鏈表裏，若是IP_ADAPTER_INFO結構體鏈表的內存長度不夠，則不會輸出任何數據到IP_ADAPTER_INFO結構體鏈表裏，但本參數任然會在輸出時存放IP_ADAPTER_INFO結構體鏈表的內存最小長度。
返回值	ERROR_SUCCESS宏（0）：成功。 ERROR_BUFFER_OVERFLOW宏（111）：失敗，MIB_IFTABLE結構體的內存長度不夠，查看dwOutBufLen參數獲取最小長度。 ERROR_INVALID_DATA宏（13）：失敗，本函數獲取到的網絡適配器信息是無效的。 ERROR_INVALID_PARAMETER宏（87）：失敗，錯誤的參數，dwOutBufLen參數爲NULL，或本函數的調用進程沒法讀寫pIfTable參數或dwOutBufLen參數指向的內存。 ERROR_NO_DATA宏（232）：失敗，本機沒有任何已啓用的網絡適配器。 ERROR_NOT_SUPPORTED宏（50）：失敗，操做系統不受支持。其餘：經過調用FormatMessage()函數查看錯誤提示信息。
錯誤碼	見返回值
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	本函數通常須要調用兩次，第一次pIfTable參數填NULL，pdwSize參數填的存放內存長度的變量爲0。而後本函數返回後，再根據pdwSize參數存放的內存最小長度分配pIfTable參數指定的內存，最後再調用本函數就能成功。也有可能第二次調用的時候狀況發生了變化，致使分配的內存長度仍是不夠，就須要不停的從新分配內存，直到本函數調用成功爲止。若是是其餘錯誤，則應該報錯跳出循環。

2.10.4.3 GetInterfaceInfo(未完成)

函數名稱	GetInterfaceInfo
頭文件	#include <Iphlpapi.h> #pragma comment(lib, "Iphlpapi.lib")
函數功能	獲取本機全部啓用了IPv4協議的物理和虛擬的網絡適配器的名稱和索引序號，不獲取任何其餘信息。只獲取已啓用的網絡適配器，不獲取已禁用的網絡適配器。不獲取回環網絡適配器。只獲取安裝並啓用了IPv4協議的網絡適配器，不獲取安裝了但未啓用IPv4協議的網絡適配器。
函數聲明	DWORD GetInterfaceInfo ( PIP_INTERFACE_INFO pIfTable, PULONG dwOutBufLen );
函數參數	pIfTable，[輸入]：存放IP_INTERFACE_INFO動態結構體的內存指針。本參數用於存放本機全部啓用了IPv4協議的物理和虛擬的網絡適配器的名稱和索引序號，本參數應該是先由程序調用malloc()等函數分配的內存。
函數參數	dwOutBufLen，[輸入&輸出]：輸入時，存放pIfTable參數指定的IP_INTERFACE_INFO動態結構體的內存長度的變量的內存指針，單位字節。輸出時，存放輸出了多少長度的數據到pIfTable參數指定的IP_INTERFACE_INFO動態結構體裏，若是IP_INTERFACE_INFO動態結構體的內存長度不夠，則不會輸出任何數據到IP_INTERFACE_INFO動態結構體裏，但本參數任然會在輸出時存放IP_INTERFACE_INFO動態結構體的內存最小長度。
返回值	ERROR_SUCCESS宏（0）：成功。 ERROR_INSUFFICIENT_BUFFER宏（122）：失敗，IP_INTERFACE_INFO結構體的內存長度不夠，查看dwOutBufLen參數獲取最小長度。 ERROR_INVALID_PARAMETER宏（87）：失敗，錯誤的參數，dwOutBufLen參數爲NULL，或本函數的調用進程沒法讀寫pIfTable參數或dwOutBufLen參數指定的內存。 ERROR_NO_DATA宏（232）：失敗，本機沒有任何已啓用的網絡適配器。 ERROR_NOT_SUPPORTED宏（50）：失敗，操做系統不受支持。其餘：經過調用FormatMessage()函數查看錯誤提示信息。
錯誤碼	見返回值
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	本函數通常須要調用兩次，第一次pIfTable參數填NULL，pdwSize參數填的存放內存長度的變量爲0。而後本函數返回後，再根據pdwSize參數存放的內存最小長度分配pIfTable參數指定的內存，最後再調用本函數就能成功。也有可能第二次調用的時候狀況發生了變化，致使分配的內存長度仍是不夠，就須要不停的從新分配內存，直到本函數調用成功爲止。若是是其餘錯誤，則應該報錯跳出循環。

2.10.5 性能計數器

Performance Counters性能計數器能夠統計硬件設備的各項性能指標。在Windows 2000及以上系統中，能夠在「控制面板-〉管理-〉性能」中看到該程序，在繪圖界面上點擊鼠標右擊，選擇「添加計數器」就有可能看到全部可統計的項目。

性能計數器能夠實時統計硬件設備的各項性能指標，經常在論壇裏看到一些新朋友問如何本身實現任務管理器，及如何實時得到每一個進程的CPU使用率，內存使用...等等，那麼使用系統性能計數器應該是最佳選擇。

MSDN：http://msdn.microsoft.com/en-us/library/windows/desktop/aa373078(v=vs.85).aspx

使用性能計數器的基本步驟：

1.建立計數器PdhOpenQuery()。

3.把感興趣的計數器添加進來PdhAddCounter()。

4.收集數據PdhCollectQueryData()。

5.獲得計數器的數值PdhGetFormattedCounterValue()。

6.關閉計數器PdhCloseQuery()。

CPU性能計數器：

\Processor(_Total)\% Processor Time

\Processor(_Total)\% User Time

\Processor(_Total)\% Privileged Time

\Processor(_Total)\Interrupts/sec

\Processor(_Total)\% DPC Time

\Processor(_Total)\% Interrupt Time

\Processor(_Total)\DPCs Queued/sec

\Processor(_Total)\DPC Rate

\Processor(_Total)\% Idle Time

內存性能計數器：

\Memory\Page Faults/sec

\Memory\Available Bytes

\Memory\Pages/sec

\Memory\Pages Input/sec

\Memory\Page Reads/sec

\Memory\Pages Output/sec

\Memory\Page Writes/sec

\Memory\Cache Bytes

\Memory\System Code Total Bytes

\Memory\Available MBytes

網絡性能計數器：

\Network Interface(Realtek RTL8139 Family PCI Fast Ethernet NIC)\Bytes Received/sec

\Network Interface(Realtek RTL8139 Family PCI Fast Ethernet NIC)\Bytes Sent/sec

\Network Interface(Realtek RTL8139 Family PCI Fast Ethernet NIC)\Bytes Total/sec

邏輯分區性能計數器：

\LogicalDisk(_Total)\Disk Reads/sec 分區每秒讀取次數

\LogicalDisk(_Total)\Disk Read Bytes/sec 分區每秒讀取字節數

\LogicalDisk(_Total)\Disk Writes/sec 分區每秒寫入次數

\LogicalDisk(_Total)\Disk Write Bytes/sec 分區每秒寫入字節數

物理硬盤性能計數器：

\PhysicalDisk(_Total)\% Disk Time 硬盤使用率

\PhysicalDisk(_Total)\Disk Reads/sec 硬盤每秒讀取次數

\PhysicalDisk(_Total)\Disk Read Bytes/sec 硬盤每秒讀取字節數

\PhysicalDisk(_Total)\Disk Writes/sec 硬盤每秒寫入次數

\PhysicalDisk(_Total)\Disk Write Bytes/sec 硬盤每秒寫入字節數

2.10.5.1 PdhOpenQuery(未完成)

函數名稱	PdhOpenQuery
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	建立一個性能計數器的查詢句柄，查詢句柄用於統一管理各項性能指標的數值。
函數聲明	PDH_STATUS PdhOpenQuery ( LPCTSTR szDataSource, DWORD_PTR dwUserData, PDH_HQUERY * phQuery );
函數參數	szDataSource，[輸入]：存放性能計數器的日誌文件路徑，該日誌裏存放着各項性能指標的數值。若是爲NULL，表示直接從實時數據源獲取各項性能指標的數值。
	dwUserData，[輸入]： User-defined value to associate with this query. To retrieve the user data later, call PdhGetCounterInfo and access the dwQueryUserData member of PDH_COUNTER_INFO. 能夠爲NULL。
	phQuery，[輸出]：存放性能計數器的查詢句柄，後續用於管理各項性能指標的數值。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.10.5.2 PdhAddCounter(未完成)

函數名稱	PdhAddCounter
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	建立一個計數器，並添加到查詢句柄。計數器用於表示要查詢哪項性能指標，添加到查詢句柄後，由查詢句柄統一收集該查詢句柄下的全部計數器的數值。
函數聲明	PDH_STATUS PdhAddCounter ( PDH_HQUERY hQuery, LPCTSTR szFullCounterPath, DWORD_PTR dwUserData, PDH_HCOUNTER * phCounter );
函數參數	hQuery，[輸入]：存放查詢句柄的值。
	szFullCounterPath，[輸入]：存放計數器路徑字符串的內存指針。格式："\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter"。
	dwUserData，[輸入]： User-defined value. This value becomes part of the counter information. To retrieve this value later, call the PdhGetCounterInfo function and access the dwUserData member of the PDH_COUNTER_INFO structure. 能夠爲NULL。
	phCounter，[輸出]：存放計數器句柄的內存指針。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	PDH_CSTATUS_BAD_COUNTERNAME宏：計數器路徑字符串沒法解析或解釋. PDH_CSTATUS_NO_COUNTER宏：在指定的計算機或性能計數器的日誌文件裏，未被找到指定的計數器。 PDH_CSTATUS_NO_COUNTERNAME宏：計數器路徑字符串是空的。 PDH_CSTATUS_NO_MACHINE宏：The path did not contain a computer name, and the function was unable to retrieve the local computer name. PDH_CSTATUS_NO_OBJECT：Unable to find the specified object on the computer or in the log file. PDH_FUNCTION_NOT_FOUND：Unable to determine the calculation function to use for this counter. PDH_INVALID_ARGUMENT宏：一個或多個參數是無效的。 PDH_INVALID_HANDLE宏：查詢句柄是無效的。 PDH_MEMORY_ALLOCATION_FAILURE宏：沒法分配足夠的內存來完成本函數的操做。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	同一個查詢句柄能夠添加多個計數器。

2.10.5.3 PdhRemoveCounter(未完成)

函數名稱	PdhRemoveCounter
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	從查詢句柄裏移除一個計數器，並關閉該計數器。移除後該計數器句柄會變成無效句柄，且不能再被使用。
函數聲明	PDH_STATUS PdhRemoveCounter ( PDH_HCOUNTER hCounter );
函數參數	hCounter，[輸入]：存放計數器句柄的值。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	PDH_INVALID_HANDLE宏：計數器句柄是無效的。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.10.5.4 PdhCollectQueryData(未完成)

函數名稱	PdhCollectQueryData
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	收集一個查詢句柄裏全部計數器的數值。收集完後，須要調用PdhGetFormattedCounterValue()函數來獲取指定計數器的數值。
函數聲明	PDH_STATUS PdhCollectQueryData ( PDH_HQUERY hQuery );
函數參數	hQuery，[輸入]：存放查詢句柄的值。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	PDH_INVALID_HANDLE宏：無效的查詢句柄。 PDH_NO_DATA宏：查詢句柄沒有添加任何計數器，或者沒有收集到任何計數器的數值，可能由於權限不足。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	有些計數器的數值是對比上一次的數值統計出來的，這類計數器只收集一次數值是無效的，須要再次調用本函數才能收集到有效的數值，由於這類計數器是統計一段時間內的性能指標變化，每一次收集到的計數器的數值都是對比上一次收集的數值統計出來的，例如每秒的CPU使用率，那麼第一次調用本函數後，須要等待一秒，而後再次調用本函數，才能收集到這一秒的CPU使用率。

2.10.5.5 PdhGetFormattedCounterValue(未完成)

函數名稱	PdhGetFormattedCounterValue
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	從一個已經收集過數值的計數器裏獲取數值。
函數聲明	PDH_STATUS PdhGetFormattedCounterValue ( PDH_HCOUNTER hCounter, DWORD dwFormat, LPDWORD lpdwType, PPDH_FMT_COUNTERVALUE pValue );
函數參數	hCounter，[輸入]：存放計數器句柄的值。
	dwFormat，[輸入]：存放獲取計數器的數值的格式標記，能夠爲（選一至一個）： PDH_FMT_DOUBLE：以DOUBLE雙精度型獲取計數器的數值。 PDH_FMT_LARGE：以LONGLONG型獲取計數器的數值。 PDH_FMT_LONG：以LONG型獲取計數器的數值。還能夠爲（用"\|"選零至多個）： PDH_FMT_NOSCALE：不使用計數器的默認縮放因子。 PDH_FMT_NOCAP100：若是設置本標記，則計數器的百分比數值的上限能夠大於100，例如：多個處理器的使用率。若是不設置本標記，則計數器的百分比數值的上限爲100。 PDH_FMT_1000：若是設置本標記，則計數器的數值乘以1000。若是不設置本標記，則計數器的數值不會乘以1000。
	lpdwType，[輸出]： Receives the counter type. For a list of counter types, see the Counter Types section of the OnlineWindows Server 2003 Deployment Kit. 能夠爲NULL。
	pValue，[輸出]：存放用於存放計數器數值的計數器數值結構體的內存指針。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	PDH_INVALID_ARGUMENT宏：有一個參數是無效的，或格式不正確。 PDH_INVALID_DATA宏：計數器句柄裏沒有收集到有效數值，或一個成功的狀態碼。 PDH_INVALID_HANDLE宏：計數器句柄是無效的。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.10.5.6 PdhCloseQuery(未完成)

函數名稱	PdhCloseQuery
頭文件	#include <Pdh.h> #pragma comment(lib, "Pdh.lib")
函數功能	關閉性能計數器的查詢句柄。
函數聲明	PDH_STATUS PdhCloseQuery ( PDH_HQUERY hQuery );
函數參數	hQuery，[輸入]：存放查詢句柄的值。
返回值	ERROR_SUCCESS宏：成功。其餘：失敗，返回值就是錯誤碼。
錯誤碼	PDH_INVALID_HANDLE宏：查詢句柄是無效的。
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.11 多進程

一個可執行程序被執行前，操做系統會先爲該可執行程序分配相關資源以供執行（如：CPU、內存、套接字等），這一系列的資源組合起來稱爲進程，也能夠稱爲是一個可執行程序的實例、實體。一個進程只能對應一個可執行程序。

一個進程剛開始執行時，只有一條執行流程，這個流程稱爲主線程。若是一個進程須要多條執行流程，就能夠在主線程裏建立多個子線程。

大多數處理器至少支持兩種執行模式：內核模式、用戶模式。內核模式下，能夠執行不少和系統硬件相關的操做。用戶模式下，則不能直接操做硬件。當線程在執行操做系統相關的函數時，線程就處於內核模式，當線程在執行非操做系統相關的函數時，線程就處於用戶模式。這樣能夠保護操做系統的內核不會被任何線程破壞。

每個進程都有一個全操做系統惟一的句柄和標識。

2.11.1 進程操做

2.11.1.1 CreateProcess(未完成)

函數名稱	CreateProcess
頭文件	#include <Windows.h>
函數功能	建立一個新進程。
函數聲明	BOOL CreateProcess ( LPCSTR lpApplicationName, LPSTR lpCommandLine, LPSECURITY_ATTRIBUTES lpProcessAttributes, LPSECURITY_ATTRIBUTES lpThreadAttributes, BOOL bInheritHandles, DWORD dwCreationFlags, LPVOID lpEnvironment, LPCSTR lpCurrentDirectory, LPSTARTUPINFOA lpStartupInfo, LPPROCESS_INFORMATION lpProcessInformation );
函數參數	lpApplicationName，[輸入] ：存放可執行文件路徑字符串的內存指針。路徑能夠爲相對或絕對路徑，不支持通配符，文件後綴名不能省略, 路徑後面不能加命令行參數，加了也自動忽略，命令行參數必須經過lpCommandLine參數傳遞。若是本參數爲相對路徑，不會自動搜索任何其餘目錄，例如Windows系統目錄，Path環境變量目錄等。若是本參數爲NULL，則lpCommandLine參數最前面必須包含可執行文件路徑，並由空格符與後面的字符分開。若是要執行BAT批處理文件，此參數必須爲"cmd.exe"，且lpCommandLine參數必須爲"/C BAT批處理文件路徑"。若是要執行16位可執行文件，此參數必須爲NULL，且在lpCommandLine參數裏包含可執行文件路徑及參數。
	lpCommandLine，[輸入]：存放執行可執行文件時傳遞的命令行參數字符串的內存指針，包括'\0'結束符最大長度爲32768字節。若是lpApplicationName參數爲NULL，此參數的可執行文件路徑字符串部分的長度不能超過MAX_PATH宏。若是不須要傳遞命令行參數，此參數的參數字符串部分就爲NULL。若是本參數不爲NULL，則此參數不能爲常量，由於Unicode版的CreateProcess()函數內部會更改參數字符串的內容，但在CreateProcess()函數返回以前，它會將該字符串恢復原樣，ANSI版的不受此限制。
	lpProcessAttributes，[輸入]：存放進程屬性結構體的內存指針，通常爲NULL。
	lpThreadAttributes，[輸入]：存放線程屬性結構體的內存指針，通常爲NULL。
	bInheritHandles：，[輸入]：指示新進程是否從調用進程處繼承了句柄。若是本參數爲非0，表示調用進程中的每個可繼承的打開句柄都將被子進程繼承，被繼承的句柄與原進程擁有徹底相同的值和訪問權限。若是本參數爲0，表示不繼承。
	dwCreationFlags，[輸入]：存放建立進程時使用的標記。能夠爲（用'\|'選零至多個）： CREATE_DEFAULT_ERROR_MODE：新的進程不繼承調用進程的錯誤模式。CreateProcess函數賦予新進程當前的默認錯誤模式做爲替代。應用程序能夠調用SetErrorMode函數設置當前的默認錯誤模式。這個標誌對於那些運行在沒有硬件錯誤環境下的多線程外殼程序是十分有用的。對於CreateProcess函數，默認的行爲是爲新進程繼承調用者的錯誤模式。設置這個標誌以改變默認的處理方式。 CREATE_NEW_CONSOLE：若是設置此標記，則新進程將使用一個新控制檯，而不是繼承調用進程的控制檯。若是不設置此標記，則這個新進程將與調用進程使用同一個控制檯。若是新進程不是控制檯程序，則此標記無心義。此標誌不能與DETACHED_PROCESS標記同時設置。 CREATE_NEW_PROCESS_GROUP：新進程將是一個進程樹的根進程。進程樹中的所有進程都是根進程的子進程。新進程樹的用戶標識符與這個進程的標識符是相同的，由lpProcessInformation參數返回。進程樹常用GenerateConsoleCtrlEvent函數容許發送CTRL+C或CTRL+BREAK信號到一組控制檯進程。 CREATE_SEPARATE_WOW_VDM：若是設置此標記，新進程將會在一個私有的虛擬DOS機（VDM）中運行。另外，默認狀況下全部的16位Windows應用程序都會在同一個共享的VDM中以線程的方式運行。單獨運行一個16位程序的優勢是一個應用程序的崩潰只會結束這一個VDM的運行；其餘那些在不一樣VDM中運行的程序會繼續正常的運行。一樣的，在不一樣VDM中運行的16位Windows應用程序擁有不一樣的輸入隊列，這意味着若是一個程序暫時失去響應，在獨立的VDM中的應用程序可以繼續得到輸入。 CREATE_SHARED_WOW_VDM：若是WIN.INI中的Windows段的DefaultSeparateVDM選項被設置爲真，這個標識使得CreateProcess函數越過這個選項並在共享的虛擬DOS機中運行新進程。 CREATE_SUSPENDED：新進程的主線程會以暫停的狀態被建立，直到調用ResumeThread()函數被調用時才運行。 CREATE_UNICODE_ENVIRONMENT：若是設置此標記，由lpEnvironment參數指定的環境變量內存塊使用Unicode字符集。若是不設置此標記，由lpEnvironment參數指定的環境變量內存塊使用ANSI字符集。 DEBUG_PROCESS：若是設置此標記，調用進程將被當作一個調試程序，而且新進程會被當作被調試的進程。系統把被調試程序發生的全部調試事件通知給調試器，且只有本函數調用進程能夠調用WaitForDebugEvent()函數。 DEBUG_ONLY_THIS_PROCESS：若是此標誌沒有被設置且調用進程正在被調試，新進程將成爲調試調用進程的調試器的另外一個調試對象。若是調用進程沒有被調試，有關調試的行爲就不會產生。 DETACHED_PROCESS：對於控制檯進程，新進程沒有訪問父進程控制檯的權限。新進程能夠經過AllocConsole函數本身建立一個新的控制檯。若是新進程不是控制檯程序，則此標記無心義。此標記不能與CREATE_NEW_CONSOLE標誌同時設置。 CREATE_NO_WINDOW：若是設置此標記，則新進程不顯示控制檯窗口。若是不設置此標記，則新進程會顯示控制檯窗口。若是新進程不是控制檯程序，則此標記無心義。如下是進程優先級標記，能夠爲（選零至一個）： HIGH_PRIORITY_CLASS：指示這個進程將執行時間臨界的任務，因此它必須被當即運行以保證正確。這個優先級的程序優先於正常優先級或空閒優先級的程序。一個例子是Windows任務列表，爲了保證當用戶調用時能夠馬上響應，放棄了對系統負荷的考慮。確保在使用高優先級時應該足夠謹慎，由於一個高優先級的CPU關聯應用程序能夠佔用幾乎所有的CPU可用時間。 IDLE_PRIORITY_CLASS：指示這個進程的線程只有在系統空閒時纔會運行而且能夠被任何高優先級的任務打斷。例如屏幕保護程序。空閒優先級會被子進程繼承。 NORMAL_PRIORITY_CLASS：指示這個進程沒有特殊的任務調度要求。 REALTIME_PRIORITY_CLASS：指示這個進程擁有可用的最高優先級。一個擁有實時優先級的進程的線程能夠打斷全部其餘進程線程的執行，包括正在執行重要任務的系統進程。例如，一個執行時間稍長一點的實時進程可能致使磁盤緩存不足或鼠標反映遲鈍。
	lpEnvironment，[輸入]：存放新進程的環境變量內存塊的內存指針，若是爲NULL，表示繼承本函數調用進程的環境變量。環境變量內存塊的格式爲"name1=value1\0name2=value2\0name3=value3\0……"。
	lpCurrentDirectory，[輸入]：存放新進程的當前活動目錄字符串的內存指針，能夠爲UNC格式。若是爲NULL，表示和調用進程使用同樣的當前活動目錄。
	lpStartupInfo，[輸入]：存放一個用於決定新進程的主窗體如何顯示的STARTUPINFO結構體的內存指針，不能爲NULL。
	lpProcessInformation，[輸出]：存放一個用來接收新進程的識別信息的PROCESS_INFORMATION結構體的內存指針，不能爲NULL。詳見
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	調用完本函數後，新進程須要先初始化完畢後才能開始運行，本函數是啓動新進程成功後就當即返回成功，不會等待新進程初始化完畢後才返回，未初始化完畢的新進程的進程和線程的句柄和標識是無效的，若是要操做新進程，必須等待初始化完畢後才能操做，不然會報ERROR_INVALID_THREAD_ID錯誤的線程標識等錯誤。若是新進程是窗口程序，能夠經過調用WaitForInputIdle()函數等待新進程初始化完畢。若是新進程是控制檯程序或沒有線程消息隊列，能夠考慮經過不停的調用PostThreadMessage()函數，直到成功爲止，由於對未初始化完畢的線程寄送消息是會報ERROR_INVALID_THREAD_ID錯誤的，當初始化完畢後，寄送消息就會成功。

2.12 多線程

每個線程都有一個全操做系統惟一的句柄和標識。

2.12.1 線程操做

2.12.1.1 CreateThread(未完成)

函數名稱	CreateThread
頭文件	#include <Windows.h>
函數功能	爲本進程建立一個新的線程，並返回線程的句柄。
函數聲明	HANDLE CreateThread ( LPSECURITY_ATTRIBUTES lpThreadAttributes, DWORD dwStackSize, LPTHREAD_START_ROUTINE lpStartAddress, LPVOID lpParameter, DWORD dwCreationFlags, LPDWORD lpThreadId );
函數參數	lpThreadAttributes，[輸入]：指向一個 SECURITY_ATTRIBUTES 結構的指針，該結構決定了線程的安全屬性，通常置爲 NULL。
	dwStackSize，[輸入]：指定了線程的堆棧長度，通常都設置爲0。
	lpStartAddress，[輸入]：表示新線程開始執行的主函數指針。線程主函數的聲明必須是DWORD WINAPI ThreadFunc (LPVOID lpThreadParameter)，ThreadFunc是線程主函數名（名稱能夠修改），lpThreadParameter爲參數名（名稱能夠修改），線程主函數只能有一個參數。
	lpParameter，[輸入]：指定傳給線程主函數的參數，不傳就爲NULL。
	dwCreationFlags，[輸入]：線程建立後是否當即執行線程主函數。若是本參數爲0，表示當即執行。若是本參數爲CREATE_SUSPENDED宏，則線程建立後，掛起狀態，並不立刻執行，之後能夠調用ResumeThread()函數喚醒線程。
	lpThreadId，[輸出]：存放新線程ID的變量的內存指針，不須要就爲NULL。
返回值	非NULL：新線程的句柄。 NULL：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	…… ……

2.12.1.2 SuspendThread

DWORD SuspendThread(HANDLE hThread);

該函數用於掛起指定的線程，若是函數執行成功，則線程的執行被終止。

2.12.1.3 ResumeThread

DWORD ResumeThread(HANDLE hThread);

該函數用於結束線程的掛起狀態，執行線程。也就是恢復指定的線程

2.12.1.4 ExitThread

VOID ExitThread(DWORD dwExitCode);

該函數用於線程終結自身的執行，主要在線程的執行函數中被調用。其中參數dwExitCode用來設置線程的退出碼。

2.12.1.5 TerminateThread

BOOL TerminateThread(HANDLE hThread,DWORD dwExitCode);

通常狀況下，線程運行結束以後，線程函數正常返回，可是應用程序能夠調用TerminateThread強行終止某一線程的執行。各參數含義以下：hThread：將被終結的線程的句柄；

dwExitCode：用於指定線程的退出碼。

使用TerminateThread()終止某個線程的執行是不安全的，可能會引發系統不穩定；雖然該函數當即終止線程的執行，但並不釋放線程所佔用的資源。所以，通常不建議使用該函數。

2.12.1.6 GetExitCodeThread(未完成)

函數名稱	GetExitCodeThread
頭文件	#include <Windows.h>
函數功能	判斷指定的線程是否終止運行，若是已經終止，就獲取該線程的退出代碼。
函數聲明	BOOL GetExitCodeThread( HANDLE hThread, LPDWORD lpExitCode );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.12.1.7 GetCurrentThreadId

GetCurrentThreadId()

獲取當前線程ID。

2.12.2 臨界區

在用戶模式工做，適用於保護線程間共享資源，一個線程能夠屢次Lock不會出錯。不支持在多進程之間工做。

#include <Windows.h>

CRITICAL_SECTION Section;

InitializeCriticalSection(&Section);//初始化臨界區

線程中使用

EnterCriticalSection(&Section);//進入臨界區

{

}

LeaveCriticalSection(&Section);//退出臨界區

2.12.3 互斥鎖

在內核模式工做，除了支持臨界區的功能，還能夠爲互斥量命名，以便在多進程中工做。互斥量比臨界區耗資源。

1、

#include <Windows.h>

HANDLE hMutex;

hMutex = CreateMutex(NULL , false, "mutex");

線程函數使用：

WaitForSingleObject(hMutex,INFINITE);

{

}

ReleaseMutex(hMutex);

2、

CMutex Section;

線程函數中使用

CsingleLock singlelock;

singlelock(&Section);

singlelock.lock();

singlelock.Unlock();

2.12.4 事件

事件對象就像一個開關：它只有兩種狀態---開和關。當一個事件處於」開」狀態，咱們稱其爲」有信號」不然稱爲」無信號」。能夠在一個線程的執行函數中建立一個事件對象，而後觀察它的狀態，若是是」無信號」就讓該線程睡眠，這樣該線程佔用的CPU時間就比較少。

產生事件對象的函數以下：

HANDLE CreateEvent(

LPSECURITY_ATTRIBUTES lpEventAttributes, // SD

BOOL bManualReset, // reset type

BOOL bInitialState, // initial state

LPCTSTR lpName // object name

);

該函數建立一個Event同步對象,若是CreateEvent調用成功的話，會返回新生成的對象的句柄，不然返回NULL。

參數說明：

lpEventAttributes 通常爲NULL

bManualReset 建立的Event是自動復位仍是人工復位.若是true,人工復位, 一旦該Event被設置爲有信號,則它一直會等到ResetEvent()API被調用時纔會恢復爲無信號. 若是爲false,Event被設置爲有信號,則當有一個wait到它的Thread時, 該Event就會自動復位,變成無信號. 若是想在每次調用WaitForSingleObject 後讓WINDOWS爲您自動地把事件地狀態恢復爲」無信號」狀態，必須把該參數設爲FALSE,不然，您必須每次調用ResetEvent函數來清除事件的信號。

bInitialState 初始狀態,true,有信號,false無信號

lpName 事件對象的名稱。您在OpenEvent函數中可能使用。

註釋：

一個Event被建立之後,能夠用OpenEvent()API來得到它的Handle,用CloseHandle()來關閉它,用SetEvent()或PulseEvent()來設置它使其有信號,用ResetEvent()來使其無信號,用WaitForSingleObject()或WaitForMultipleObjects()來等待其變爲有信號。

PulseEvent()是一個比較有意思的使用方法,正如這個API的名字,它使一個Event 對象的狀態發生一次脈衝變化,從無信號變成有信號再變成無信號,而整個操做是原子的。

對自動復位的Event對象,它僅釋放第一個等到該事件的thread（若是有),而對於人工復位的Event對象,它釋放全部等待的thread。

這裏有兩個API函數用來修改事件對象的信號狀態：SetEvent和ResetEvent。前者把事件對象設爲」有信號」狀態，然後者正好相反。

在事件對象生成後，必須調用WaitForSingleObject來讓線程進入等待狀態，該函數的語法以下：

WaitForSingleObject(HANDLE hHandle, DWORD dwMilliseconds)

hHandle-->指向同步對象的指針。事件對象實際上是同步對象的一種。

dwMilliseconds--> 等待同步對象變成」有信號」前等待的時間，以毫秒計。當等待的時間超過該值後無信號同步對象仍處於」無信號」狀態，線程再也不等待， WaitForSingleObject函數會返回。若是想要線程一直等待，請把該參數設爲INFINITE（該值等於0xffffffff)。

2.13 服務

2.13.1 OpenSCManager(未完成)

函數名稱	OpenSCManager
頭文件	#include <Winsvc.h>
庫文件	#pragma comment(lib, "Advapi32.lib")
函數功能	打開服務控制管理數據庫，並返回服務控制管理數據庫句柄。
函數聲明	SC_HANDLE WINAPI OpenSCManager ( LPCTSTR lpMachineName, LPCTSTR lpDatabaseName, DWORD dwDesiredAccess );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.13.2 CloseServiceHandle(未完成)

函數名稱	CloseServiceHandle
頭文件	#include <Winsvc.h>
庫文件	#pragma comment(lib, "Advapi32.lib")
函數功能	關閉服務控制管理數據庫句柄。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.13.3 CreateService(未完成)

函數名稱	CreateService
頭文件	#include <Winsvc.h>
庫文件	#pragma comment(lib, "Advapi32.lib")
函數功能	建立一個服務對象，並將其添加到指定的服務控制管理器數據庫。
函數聲明	SC_HANDLE WINAPI CreateService ( SC_HANDLE hSCManager, LPCTSTR lpServiceName, LPCTSTR lpDisplayName, DWORD dwDesiredAccess, DWORD dwServiceType, DWORD dwStartType, DWORD dwErrorControl, LPCTSTR lpBinaryPathName, LPCTSTR lpLoadOrderGroup, LPDWORD lpdwTagId, LPCTSTR lpDependencies, LPCTSTR lpServiceStartName, LPCTSTR lpPassword );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.13.4 QueryServiceStatus(未完成)

函數名稱	QueryServiceStatus
頭文件	#include <Winsvc.h>
庫文件	#pragma comment(lib, "Advapi32.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.13.5 ControlService(未完成)

函數名稱	ControlService
頭文件	#include <Winsvc.h>
庫文件	#pragma comment(lib, "Advapi32.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14 可視化窗口

每一個窗口都有一個三維座標，X軸表示窗口在屏幕的橫座標位置，最左邊爲0，依次向右每個像素遞增一，Y軸表示窗口在屏幕的縱座標位置，最上邊爲0，依次向下每個像素遞增一，Z軸表示窗口擋在其餘窗口的前面仍是躲在後面，從遠往近看，Z軸座標越大的就會擋在其餘的控件或窗口的前面。

控件	MFC類	描述
動畫	CAnimateCtrl	顯示連續的AVI視頻剪輯
按鈕	CButton	用來產生某種行爲的按鈕，以及複選框、單選鈕和組框
組合框	CComboBox	編輯框和列表框的組合
編輯框	CEdit	用於鍵入文本
標題頭	CHeaderCtrl	位於某一行文本之上的按鈕，可用來控制顯示文件的寬度
熱鍵	CHotKeyCtrl	用於經過按下某一組合鍵來很快的執行某些經常使用的操做
圖象列表	CImageList	一系列圖象(典型狀況下是一系列圖標或位圖)的集合。圖象列表自己不是一種控件，它經常是和其它控件一塊兒工做，爲其它控件提供所用的圖象列表
列表	CListCtrl	顯示文本及其圖標列表的窗口
列表框	CListBox	包括一系列字符串的列表
進度	CProgressCtrl	用於在一較長操做中提示用戶所完成的進度
多格式文本編輯	CRichEditCtrl	提供可設置字符和段落格式的文本編輯的窗口
滾動條	CScrollBar	爲對話框提供控件形式的滾動條
滑塊	CSliderCtrl	包括一個有可選標記的滑塊的窗口
旋轉按鈕	CSpinButtonCtrl	提供一對可用於增減某個值的箭頭
靜態文本	CStatic	經常使用於爲其它控件提供標籤
狀態條	CStatusBarCtrl	用於顯示狀態信息的窗口，同MFC類CStatusBar相似
選項卡	CTabCtrl	在選項卡對話框或屬性頁中提供具備相似筆記本中使用的分隔標籤的外觀的選項卡
工具條	CToolBarCtrl	具備一系列命令生成按鈕的窗口，同MFC類CToolBar相似
工具提示	CToolTipCtrl	一個小的彈出式窗口，用於提供對工具條按鈕或其它控件功能的簡單描述
樹	CTreeCtrl	用於顯示一系列的項的繼承結構

2.14.1 窗口位置、窗口大小

2.14.1.1 GetWindowRect(未完成)

函數名稱	GetWindowRect
頭文件	#include <Windows.h>
函數功能	獲取指定的窗口的左邊、頂邊、右邊、底邊在屏幕上的位置。
函數聲明	BOOL GetWindowRect ( HWND hWnd, LPRECT lpRect );
函數參數	hWnd，[輸入]：存放要獲取哪一個窗口句柄的位置，不能爲NULL。
函數參數	lpRect，[輸出]：存放位置結構體的內存指針，用於存放指定的窗口在屏幕上的位置。
返回值	非0：成功 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.1.2 SetWindowPos(未完成)

函數名稱	SetWindowPos
頭文件	#include <Windows.h>
函數功能	改變一個窗口的Z軸順序、位置、尺寸、樣式。
函數聲明	BOOL SetWindowPos ( HWND hWnd, HWND hWndInsertAfter, int X, int Y, int cx, int cy, UINT uFlags );
函數參數	hWnd，[輸入]：存放要改變的窗口的句柄。
	hWndInsertAfter，[輸入]：存放要將hWnd參數指定的窗口定位在哪些窗口句柄的前面。若是不想定位窗口，就在uFlags參數中設置SWP_NOZORDER標記，則本參數將被忽略，不然本參數不能爲NULL。此參數也能夠爲（選一至一個）： HWND_BOTTOM（1）：若是hWnd參數指定的窗口是當前激活窗口，將此窗口定位在Z軸順序的底部，也就是全部窗口的後面，且若是此窗口是置頂窗口，就變成非置頂窗口。若是hWnd參數指定的窗口不是當前激活窗口，則不作任何定位，不管此窗口是置頂窗口，仍是非置頂窗口。 HWND_NOTOPMOST（-2）：若是hWnd參數指定的窗口是置頂窗口，且是當前激活窗口，就變成非置頂窗口，並定位在全部非置頂窗口的前面，及在全部置頂窗口的後面。若是hWnd參數指定的窗口已是一個非置頂窗口，或不是當前激活窗口，則不作任何定位。 HWND_TOP（0）：若是hWnd參數指定的窗口是非置頂窗口，且是當前激活窗口，將窗口定位在全部非置頂窗口的前面，及在全部置頂窗口的後面。若是hWnd參數指定的窗口已是一個置頂窗口，或不是當前激活窗口，則不作任何定位。 HWND_TOPMOST（-1）：將hWnd參數指定的窗口定位在全部非置頂窗口和置頂窗口的前面，並將窗口變成置頂窗口,不管此窗口是否是當前激活窗口。若是hWnd參數指定的窗口在置頂後，又有其餘窗口被置頂，則此窗口將被定位在其餘置頂窗口的後面。若是要一直保持某個窗口的置頂位置，須要每隔一段時間就設置一次置頂，才能保證不被其餘窗口蓋住。
	X，[輸入]：存放將hWnd參數指定的窗口的左邊移動到屏幕的哪一個像素。若是不想移動窗口，就在uFlags參數中設置SWP_NOMOVE標記，則本參數將被忽略。
	Y，[輸入]：存放將hWnd參數指定的窗口的頂邊移動到屏幕的哪一個像素。若是不想移動窗口，就在uFlags參數中設置SWP_NOMOVE標記，則本參數將被忽略。
	cx，[輸入]：存放將hWnd參數指定的窗口的左邊至右邊的長度改成多少個像素。若是不想修改窗口尺寸，就在uFlags參數中設置SWP_NOSIZE標記，則本參數將被忽略。注意：本參數是邊框長度，不是像素位置。
	cy，[輸入]：存放將hWnd參數指定的窗口的頂邊至低邊的長度改成多少個像素。若是不想修改窗口尺寸，就在uFlags參數中設置SWP_NOSIZE標記，則本參數將被忽略。注意：本參數是邊框長度，不是像素位置。
	uFlags，[輸入]：存放操做窗口的位置和大小的標記，能夠爲（用'\|'選零至多個）： SWP_DRAWFRAME： Draws a frame (defined when the window was created) around the window. SWP_FRAMECHANGED： Sends a WM_NCCALCSIZE message to the window, even if the window's size is not being changed. If this flag is not specified, WM_NCCALCSIZE is sent only when the window's size is being changed. SWP_HIDEWINDOW： Hides the window. SWP_SHOWWINDOW： Displays the window. SWP_NOACTIVATE： Does not activate the window. If this flag is not set, the window is activated and moved to the top of either the topmost or the non-topmost group (depending on the setting of the pWndInsertAfter parameter). SWP_NOCOPYBITS： Discards the entire contents of the client area. If this flag is not specified, the valid contents of the client area are saved and copied back into the client area after the window is sized or repositioned. SWP_NOOWNERZORDER： Does not change the owner window's position in the Z-order. SWP_NOREDRAW： Does not redraw changes. If this flag is set, no repainting of any kind occurs. This applies to the client area, the nonclient area (including the title and scroll bars), and any part of the parent window uncovered as a result of the moved window. When this flag is set, the application must explicitly invalidate or redraw any parts of the window and parent window that must be redrawn. SWP_NOREPOSITION： Same as SWP_NOOWNERZORDER. SWP_NOSENDCHANGING： Prevents the window from receiving the WM_WINDOWPOSCHANGING message. SWP_NOMOVE：若是設置本標記，表示不改變窗口的左邊、頂邊的位置，並忽略X參數、Y參數。若是不設置本標記，表示須要改變窗口的左邊、頂邊的位置，並使X參數、Y參數有效。 SWP_NOSIZE：若是設置本標記，表示不改變窗口的左右、上下的大小，並忽略cx參數、cy參數。若是不設置本標記，表示須要改變窗口的左右、上下的大小，並使cx參數、cy參數有效。 SWP_NOZORDER：若是設置本標記，表示不改變窗口的Z軸順序，並忽略hWndInsertAfter參數。若是不設置本標記，表示須要改變窗口的Z軸順序，並使hWndInsertAfter參數有效。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.2 MessageBox(未完成)

函數名稱	MessageBox
頭文件	#include <Windows.h>
函數功能	顯示一個消息對話框，其中包含一組按鈕、一個系統圖標和一句消息，如狀態或錯誤的消息。消息對話框中返回一個整數值，該值指示用戶單擊了哪一個按鈕。
函數聲明	int MessageBox ( HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType );
函數參數	hWnd，[輸入]：存放消息對話框的父窗口。若是爲NULL，表示消息框框沒有父窗口。
	lpText，[輸入]：存放消息對話框的消息字符串。
	lpCaption，[輸入]：存放消息對話框的標題字符串。若是爲NULL，默認就是「錯誤」。
	uType，[輸入]：存放出如今消息對話框的行爲標記，用'\|'選按鈕、圖標、窗體和其餘標記。按鈕，默認爲MB_OK標記，能夠是（選零至一個）： MB_OK：只有「肯定」按鈕。 MB_YESNO：有「是」和「否」按鈕。 MB_ABORTRETRYIGNORE：有「放棄」，「重試」和「忽略」按鈕。 MB_YESNOCANCEL：有「是」，「否」和「取消」按鈕。 MB_RETRYCANCEL：有「重試」和「取消」按鈕。 MB_OKCANCEL：有「肯定」和「取消」按鈕。 MB_CANCELTRYCONTINUE：有「取消」，「重試」和「繼續」按鈕。默認按鈕，默認爲MB_DEFBUTTON1標記，能夠是（選零至一個）： MB_DEFBUTTON1：第一個按鈕是默認按鈕。 MB_DEFBUTTON2：第二個按鈕是默認按鈕。 MB_DEFBUTTON3：第三個按鈕是默認按鈕。 MB_DEFBUTTON4：第四個按鈕是默認按鈕。圖標，默認沒有圖標，能夠是（選零至一個）： MB_ICONEXCLAMATION：驚歎號警告圖標，黃色三角形中間一個感嘆號。 MB_ICONWARNING：同MB_ICONEXCLAMATION標記。 MB_ICONINFORMATION：提示信息圖標，圓圈中小寫字母i組成的圖標。 MB_ICONASTERISK：同MB_ICONINFORMATION標記。 MB_ICONQUESTION：問題標記圖標。 MB_ICONSTOP：錯誤中止圖標。 MB_ICONERROR：同MB_ICONSTOP標記。 MB_ICONHAND：同MB_ICONSTOP標記。窗體，默認爲MB_APPLMODAL標記，能夠是（選零至一個）： MB_APPLMODAL：消息對話框顯示在父窗口之上，用戶必須單擊消息對話框的按鈕後才能使用父窗口，不影響其餘窗口使用。 MB_SYSTEMMODAL：消息對話框顯示在系統全部窗口之上，用戶必須單擊消息對話框的按鈕後才能使用父窗口，不影響其餘窗口使用。 MB_TASKMODAL：消息對話框顯示在本進程全部窗口之上，用戶必須單擊消息對話框的按鈕後才能使用本進程其餘窗口，不影響其餘進程窗口使用。其餘，能夠是（選零至多個）： MB_DEFAULT_DESKTOP_ONLY：接收輸入的當前桌面必定是一個缺省桌面。不然，函數調用失敗。缺省桌面是一個在用戶已經紀錄且之後應用程序在此上面運行的桌面。 MB_HELP：把一個幫助按鈕增長到消息對話框。用戶單擊幫助按鈕或按F1鍵後產生一個WM_HELPINFO消息。 MB_RIGHT：若是設置此標記，消息對話框的消息字符串向右對齊。若是不設置此標記，消息對話框的消息字符串向左對齊。 MB_RTLREADING：用在Hebrew和Arabic系統中從右到左的順序顯示消息和大寫文本。 MB_SETFOREGROUND：消息對話框設置爲活動窗口，本函數會在內部調用SetForegroundWindow()函數。 MB_TOPMOSI：消息對話框用WS_EX_TOPMOST窗口類型來建立，也就是顯示在系統全部窗口之上。 MB_SERVICE_NOTIFICATION： MB_SERVICE_NOTIFICATION_NT3X：
返回值	0：失敗，調用GetlastError()函數查看錯誤碼。 IDABORT宏：用戶單擊了「放棄」按鈕。 IDCANCEL宏：用戶單擊了「取消」按鈕。 IDCONTINUE宏：用戶單擊了「繼續」按鈕。 IDIGNORE宏：用戶單擊了「忽略」按鈕。 IDNO宏：用戶單擊了「否」按鈕。 IDOK宏：用戶單擊了「是」按鈕。 IDRETRY宏：用戶單擊了「重試」按鈕。 IDYES宏：用戶單擊了「肯定」按鈕。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.14.3 FindWindow(未完成)

函數名稱	FindWindow
頭文件	#include <xxx.h> #include <xxx.h>
庫文件	#pragma comment(lib, "xxx.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.4 樣式

2.14.4.1 ModifyStyle(未完成)

函數名稱	ModifyStyle
頭文件	#include <Windows.h>
函數功能	根據指定的窗口句柄，動態添加並刪除該窗口的普通樣式，並當即生效。
函數聲明	BOOL ModifyStyle ( HWND hWnd, DWORD dwRemove, DWORD dwAdd, UINT nFlags );
函數參數	hWnd，[輸入]：存放要修改樣式的窗口的句柄的值，該窗口必須已經建立。
	dwRemove，[輸入]：存放要刪除的普通樣式的值，通常爲該窗口的樣式宏。若是不須要刪除，本參數填0。例如：列表控件的大圖標視圖樣式的宏定義爲LVS_ICON。
	dwAdd，[輸入]：存放要添加的普通樣式的值，通常爲該窗口的樣式宏。若是不須要添加，本參數填0。例如：列表控件的大圖標視圖樣式的宏定義爲LVS_ICON。
	nFlags，[輸入]：存放須要調用SetWindowPos()函數修改的樣式，不須要就填0，本參數能夠爲（用'\|'選零至多個）： SWP_NOSIZE：保持當前大小。 SWP_NOMOVE：保持當前位置。 SWP_NOZORDER：保持當前的Z次序。 SWP_NOACTIVATE：不激活該窗口。
返回值	非0：成功。 0：失敗。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	有些窗口的普通樣式是衝突的，須要同時刪除舊樣式，並添加新樣式，不然會致使失敗。有些窗口的普通樣式是不能夠動態添加或刪除的，不然會致使失敗。本函數只能修改普通樣式，不能修改擴展樣式，修改擴展樣式需調用ModifyStyleEx()函數。

2.14.5 CDC圖形設備環境類

CDC類是在顯示數據，或者使用圖形，或者使用文本中必不可少的。Windows使用與設備無關的圖形設備環境（DC：Device Context）進行顯示。MFC基礎類庫定義了圖形設備環境類----CDC類。

2.14.5.1 CDC::GetTextExtent(未完成)

函數名稱	GetTextExtent
頭文件	#include <Windows.h>
函數功能	根據本類對象設置的字體，計算一個字符串顯示在窗口上的像素尺寸。
函數聲明	CSize GetTextExtent ( const CString & str ); CSize GetTextExtent ( LPCTSTR lpszString, int nCount );
函數參數	str，[輸入]：存放要計算像素尺寸的字符串的CString字符串類對象。
	lpszString，[輸入]：存放要計算像素尺寸的字符串的內存指針。
	nCount，[輸入]：存放要計算像素尺寸的字符串的內存長度的值。
返回值	字符串的上下和左右的像素尺寸
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	設置本類對象的字體能夠調用CDC::SelectObject()函數。

2.14.6 CFont字體類

CFont類封裝了一個Windows圖形設備接口（GDI）字體，併爲操做字體提供了成員函數。

Windows提供了多種與設備無關的不一樣尺寸的字體。有效地使用這些Windows字體，不用在編程時下很大功夫，就能夠明顯地加強各類應用程序的功能。字體是Windows GDI必要的組成部分，這意味字體的使用與其餘GDI對象同樣。它們能夠縮放和剪切，能夠像選取畫筆或者畫刷同樣選取設備環境。全部關於撤消選中和刪除的GDI規則都適用於字體。

2.14.6.1 CFont::CreatePointFont(未完成)

函數名稱	CreatePointFont
頭文件	#include <Windows.h>
函數功能	修改本字體類對象的字體。
函數聲明	BOOL CreatePointFont ( int nPointSize, LPCTSTR lpszFaceName, CDC* pDC );
函數參數	nPointSize，[輸入]：存放新字體的大小的值，該值要在實際大小上再乘以10，例如字體大小爲11，則本參數就填110。
	lpszFaceName，[輸入]：存放字體名稱字符串的內存指針，例如字體爲宋體，則本參數就填"宋體"。
	pDC，[輸入]： Pointer to the CDC object to be used to convert the height in nPointSize to logical units. If NULL, a screen device context is used for the conversion.
返回值	非0：成功。 0：失敗。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是本類對象的字體再也不使用了，應該調用DeleteObject()函數釋放本類對象的字體資源，在本類對象被釋放時，會自動釋放字體資源。

2.14.7 CWnd窗口基類

CWnd類是MFC窗口類的基類，提供了微軟基礎類庫中全部窗口類的基本功能。

2.14.7.1 CWnd::SetFont

函數名稱	SetFont
頭文件	#include <Windows.h>
函數功能	設置本窗口類對象的字體。
函數聲明	void SetFont ( CFont * pFont, BOOL bRedraw );
函數參數	pFont，[輸入]：存放字體類對象的內存指針。建立字體類對象能夠參考CFont::CreatePointFont()函數。
函數參數	bRedraw，[輸入]：存放是否要在設置完字體後當即重繪窗口，非0表示須要當即重繪，0表示不須要當即重繪。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	本函數其實是對本窗口類對象發送WM_SETFONT消息，若是本窗口類對象沒有處理該消息，則本函數無效。

2.14.8 CListCtrl列表控件類

列表控件分爲四種視圖：圖標視圖、小圖標視圖、列表視圖、報表視圖。

圖標視圖：，小圖標視圖：

列表視圖：，報表視圖：

列表控件中每一行爲一個項目，每個項目都有一至多個字段，每一個字段都有圖標和標籤。

圖標視圖、小圖標視圖、列表視圖直接能夠插入項目，可是隻能顯示每一個項目的第一個字段的圖標和標籤，即便插入了其餘的字段也不能顯示。

報表視圖必須先插入字段頭，而後才能插入項目，要否則插入的項目不會顯示。報表視圖中能夠同時顯示每一個項目的每一個字段的圖標和標籤。

項目索引號是每一個項目的惟一標識，用於操做項目時起定位做用，項目索引號始終是連續的，且第一個項目的索引號始終爲0，第二個項目的索引號始終爲1，以此類推。

字段索引號是某一項目的每一個字段的惟一標識，用於操做項目的字段時起定位做用，字段索引號始終是連續的，且每一個項目的第一個字段的索引號始終爲0，每一個項目的第二個字段的索引號始終爲1，以此類推。

2.14.8.1 CListCtrl::InsertItem(未完成)

函數名稱	InsertItem
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	向列表控件中插入一個新項目。
函數聲明	int InsertItem ( const LVITEM * pItem ); int InsertItem ( int nItem, LPCTSTR lpszItem ); int InsertItem ( int nItem, LPCTSTR lpszItem, int nImage ); int InsertItem ( UINT nMask, int nItem, LPCTSTR lpszItem, UINT nState, UINT nStateMask, int nImage, LPARAM lParam );
函數參數	pItem，[輸入]：存放LVITEM結構體的內存指針，新項目的各類參數都在該結構體中。
	nItem，[輸入]：存放新項目的索引號，本參數只能大於等於0。
	lpszItem，[輸入]：存放新項目的主項目的標籤字符串的內存指針。若是本參數爲LPSTR_TEXTCALLBACK宏，表示項目的標籤爲虛擬標籤，詳情請參考LVITEM結構體的pszText成員變量。
	nImage，[輸入]： Index of the item's image, or I_IMAGECALLBACK if the item is a callback item. For information on callback items, see CListCtrl::GetCallbackMask.
	nMask，[輸入]：存放本函數有哪些參數有效的標記，能夠爲（用'\|'選零至多個）：
	nState，[輸入]：參數說明。
	nStateMask，[輸入]：參數說明。
	lParam，[輸入]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是新項目的索引號在列表控件中已經存在，則該索引號的項目及之後的項目所有加一，新項目插入到該索引號對應位置。若是新項目的索引號在列表控件中不存在，則新項目就插入到列表控件的最後一行，並把新項目的索引號修改成插入前最後一個項目的索引號加一，若是列表控件中沒有任何項目，則新項目就在第一行，且索引號爲0。

2.14.8.2 CListCtrl::DeleteItem(未完成)

函數名稱	DeleteItem
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	刪除列表控件中某個項目。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.3 CListCtrl::DeleteAllItems(未完成)

函數名稱	DeleteAllItems
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	刪除列表控件中全部的項目。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.4 CListCtrl::InsertColumn(未完成)

函數名稱	InsertColumn
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	向列表控件中插入一個新字段頭。
函數聲明	int InsertColumn ( int nCol, const LVCOLUMN * pColumn ); int InsertColumn ( int nCol, LPCTSTR lpszColumnHeading, int nFormat = LVCFMT_LEFT, int nWidth = -1, int nSubItem = -1 );
函數參數	nCol，[輸入]：存放新字段頭的索引號，本參數只能大於等於0。
	pColumn，[輸入]：參數說明。
	lpszColumnHeading，[輸入]：存放新字段頭的標籤字符串的內存指針，不能爲NULL。
	nFormat，[輸入]：存放新字段頭的標籤、及每一個項目的在新字段的標籤的對齊方式的值，能夠爲（選一至一個）： LVCFMT_LEFT(0x0000)：向左對齊。 LVCFMT_RIGHT(0x0001)：向右對齊。 LVCFMT_CENTER(0x0002)：居中對齊。注意：若是新字段頭的索引號爲0，則本參數將忽略。若是要設置索引號爲0的字段的對齊方式，有如下幾種方法：一、能夠先插入索引號爲1的字段，而後再調用CListCtrl::DeleteColumn()函數刪除索引號爲0的字段。二、插入索引號爲0的字段後，再調用CListCtrl::SetColumn()函數修改字段的對齊方式。
	nWidth，[輸入]：存放新字段頭的初始寬度的值，單位像素。若是本參數爲-1，表示使用默認寬度，通常爲10。若是本參數爲0或小於-1，表示寬度爲0。
	nSubItem，[輸入]： Index of the subitem associated with the column. If this parameter is -1, no subitem is associated with the column.
返回值	-1：失敗。其餘：新字段的實際索引號。
錯誤碼	無
線程安全	否
原子操做	否
其餘說明	只有報表視圖才能顯示字段頭，且報表視圖必須插入字段頭才能顯示列表控件中的項目。若是新字段頭的索引號在列表控件中已經存在，則該索引號的字段頭及之後的字段頭所有加一，新字段頭插入到該索引號對應位置。若是新字段頭的索引號在列表控件中不存在，則新字段頭就插入到列表控件的最後一個，並把新字段頭的索引號修改成插入前最後一個字段頭的索引號加一，若是列表控件中沒有任何字段頭，則新字段頭就在第一個，且索引號爲0。

2.14.8.5 CListCtrl::DeleteColumn

函數名稱	DeleteColumn
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	從列表控件中刪除一個字段頭。
函數聲明	BOOL DeleteColumn ( int nCol );
函數參數	nCol，[輸入]：存放要刪除的字段頭的索引號，本參數只能大於等於0。
返回值	非0：成功。 0：失敗，要刪除的字段頭的索引號不存在。
錯誤碼	無
線程安全	否
原子操做	否
其餘說明	若是要刪除的字段頭後面還有字段頭，則後面的字段頭的索引號所有將減一。

2.14.8.6 CListCtrl::GetColumnWidth(未完成)

函數名稱	GetColumnWidth
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件中某個字段頭的寬度，單位像素。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.7 CListCtrl::SetColumnWidth(未完成)

函數名稱	SetColumnWidth
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置列表控件中某個字段頭的寬度，單位像素。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.8 CListCtrl::GetExtendedStyle(未完成)

函數名稱	GetExtendedStyle
頭文件	#include <Windows.h>
庫文件	無
函數功能	獲取列表控件對象的擴展樣式。
函數聲明	DWORD GetExtendedStyle ( );
函數參數	無
返回值	擴展樣式的標記值，能夠爲（用'\|'選零至多個）： LVS_EX_GRIDLINES（0x00000001）：在報表視圖中，若是設置本標記，表示顯示網格線，若是不設置本標記，表示隱藏網格線。 LVS_EX_SUBITEMIMAGES（0x00000002）：在報表視圖中，若是設置本標記，表示每一個項目的每一個字段均可以顯示圖標，若是不設置本標記，表示每一個項目只有第一個字段才能顯示圖標，隱藏其餘字段的圖標。 LVS_EX_CHECKBOXES（0x00000004）：在任何視圖中，若是設置本標記，表示每一個項目都帶複選框，若是不設置本標記，表示每一個項目都不帶複選框。注意：能夠調用CListCtrl::GetCheck()函數獲取複選框狀態，調用CListCtrl::SetCheck()函數設置複選框狀態。 LVS_EX_TRACKSELECT（0x00000008）：在任何視圖中，若是設置本標記，表示鼠標在某項目上懸停一段時間後自動選中該項目，若是不設置本標記，表示不會自動選中項目。 LVS_EX_HEADERDRAGDROP（0x00000010）：在報表視圖中，若是設置本標記，表示每列報表頭能夠拖動順序，但每列序號不變，若是不設置本標記，表示每列報表頭順序固定。 LVS_EX_FULLROWSELECT（0x00000020）：在報表視圖中，若是設置本標記，表示在每一個項目的整行全部字段均可以選中該項目，若是不設置本標記，表示只能在每一個項目的第一字段選中該項目。 LVS_EX_ONECLICKACTIVATE（0x00000040）：在任何視圖中，若是設置本標記，表示單擊任何項目便可選中該項目，並向父窗口發送LVN_ITEMACTIVATE項目激活消息，若是不設置本標記，表示單擊任何項目都不發送LVN_ITEMACTIVATE項目激活消息。 LVS_EX_TWOCLICKACTIVATE（0x00000080）：在任何視圖中，若是設置本標記，表示單擊任何已選中的項目，會向父窗口發送LVN_ITEMACTIVATE項目激活消息，若是不設置本標記，表示單擊任何已選中的項目都不發送LVN_ITEMACTIVATE項目激活消息。 LVS_EX_FLATSB（0x00000100）：在任何視圖中，若是設置本標記，表示使用扁平化風格顯示滾動條，若是不設置本標記，表示使用普通風格顯示滾動條。 LVS_EX_REGIONAL（0x00000200）：在圖標視圖中，若是設置本標記，表示只顯示每一個項目的圖標和文本，隱藏列表控件的邊框、背景、滾動條、複選框等，若是不設置本標記，表示正常顯示。 LVS_EX_INFOTIP（0x00000400）：在任何視圖中，若是設置本標記，表示當某個項目須要顯示Tooltip工具提示控件時，向父窗口發送LVN_GETINFOTIP消息，若是不設置本標記，表示不顯示Tooltip工具提示控件，也不向父窗口發送LVN_GETINFOTIP消息。 LVS_EX_UNDERLINEHOT（0x00000800）：在任何視圖中，若是設置本標記，表示在鼠標懸停的項目上顯示下劃線，若是不設置本標記，表示在鼠標懸停的項目上不顯示下劃線。 LVS_EX_UNDERLINECOLD（0x00001000）：在任何視圖中，若是設置本標記，表示在鼠標未懸停的項目上顯示下劃線，若是不設置本標記，表示在鼠標未懸停的項目上不顯示下劃線。 LVS_EX_MULTIWORKAREAS（0x00002000）：多工做區。 LVS_EX_LABELTIP（0x00004000）： LVS_EX_BORDERSELECT（0x00008000）：在任何視圖中，若是設置本標記，表示經過改變邊框顏色方式來顯示已選中的項目，若是不設置本標記，表示經過高亮方式來顯示已選中的項目。如下標記須要XP及之後的系統才支持： LVS_EX_DOUBLEBUFFER（0x00010000）：在任何視圖中，若是設置本標記，表示本控件使用雙緩衝方式來進行重繪，雙緩衝方式下能夠減小頻繁重繪時控件的閃爍，若是不設置本標記，表示本控件使用正常方式進行重繪，正常方式下頻繁重繪可能致使控件閃爍。 LVS_EX_HIDELABELS（0x00020000）： LVS_EX_SINGLEROW（0x00040000）： LVS_EX_SNAPTOGRID（0x00080000）： LVS_EX_SIMPLESELECT（0x00100000）：如下標記須要VISTA及之後的系統才支持： LVS_EX_JUSTIFYCOLUMNS（0x00200000）： LVS_EX_TRANSPARENTBKGND（0x00400000）： LVS_EX_TRANSPARENTSHADOWTEXT（0x00800000）： LVS_EX_AUTOAUTOARRANGE（0x01000000）： LVS_EX_HEADERINALLVIEWS（0x02000000）： LVS_EX_AUTOCHECKSELECT（0x08000000）： LVS_EX_AUTOSIZECOLUMNS（0x10000000）： LVS_EX_COLUMNSNAPPOINTS（0x40000000）： LVS_EX_COLUMNOVERFLOW（0x80000000）：
錯誤碼	無
線程安全	是
原子操做	否
其餘說明

2.14.8.9 CListCtrl::SetExtendedStyle

函數名稱	SetExtendedStyle
頭文件	#include <Windows.h>
庫文件	無
函數功能	設置列表控件對象的擴展樣式。
函數聲明	DWORD SetExtendedStyle ( DWORD dwNewStyle );
函數參數	dwNewStyle，[輸入]：存放新的擴展樣式的值，參考CListCtrl::GetExtendedStyle()函數的返回值。
返回值	成功設置了哪些擴展樣式到列表控件
錯誤碼	無
線程安全	否
原子操做	否
其餘說明

2.14.8.10 CListCtrl::GetItemText(未完成)

函數名稱	GetItemText
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件中某個項目的某個字段的標籤。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.11 CListCtrl::SetItemText(未完成)

函數名稱	SetItemText
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置列表控件中某個項目的某個字段的標籤。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.12 CListCtrl::GetCheck

函數名稱	GetCheck
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取某個項目的複選框的狀態。
函數聲明	BOOL GetCheck ( int nItem );
函數參數	nItem，[輸入]：存放項目的索引號的值，項目的索引號從0開始。
返回值	-1：項目沒有帶複選框，或指定的項目不存在。 1：複選框處於選中狀態。 0：複選框處於未選中狀態。
錯誤碼	無
線程安全	否
原子操做	否
其餘說明	使用本函數前，須要列表控件具備LVS_EX_CHECKBOXES擴展樣式。

2.14.8.13 CListCtrl::SetCheck

函數名稱	SetCheck
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置某個項目的複選框的狀態。
函數聲明	BOOL SetCheck ( int nItem, BOOL fCheck = TRUE );
函數參數	nItem，[輸入]：存放項目的索引號的值，項目的索引號從0開始。
函數參數	fCheck，[輸入]：存放項目的複選框要設置的狀態，非0表示選中，0表示未選中。
返回值	1：成功，或項目沒有帶複選框。 0：失敗，多是指定的項目不存在。
錯誤碼	無
線程安全	否
原子操做	否
其餘說明

2.14.8.14 CListCtrl::GetBkColor(未完成)

函數名稱	GetBkColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件的背景色。
函數聲明	COLORREF GetBkColor ( void );
函數參數	無
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.15 CListCtrl::SetBkColor(未完成)

函數名稱	SetBkColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置列表控件的背景色。
函數聲明	BOOL SetBkColor ( COLORREF cr );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.16 CListCtrl::GetTextBkColor(未完成)

函數名稱	GetTextBkColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件的所有項目的背景色。
函數聲明	COLORREF GetTextBkColor ( void );
函數參數	無
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.17 CListCtrl::SetTextBkColor(未完成)

函數名稱	SetTextBkColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置列表控件的所有項目的背景色。
函數聲明	BOOL SetTextBkColor ( COLORREF cr );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.18 CListCtrl::GetTextColor(未完成)

函數名稱	GetTextColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件的所有項目的標籤的顏色。
函數聲明	COLORREF GetTextColor ( void );
函數參數	無
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.19 CListCtrl::SetTextColor(未完成)

函數名稱	SetTextColor
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	設置列表控件的所有項目的標籤的顏色。
函數聲明	BOOL SetTextColor ( COLORREF cr );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.14.8.20 CListCtrl::GetSelectedCount(未完成)

函數名稱	GetSelectedCount
頭文件	#include <afxcmn.h>
庫文件	無
函數功能	獲取列表控件中被選中的項目總數。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.14.8.21 LVN_GETDISPINFO(未完成)

消息名稱

LVN_GETDISPINFO

函數名稱

OnLvnGetdispinfo

頭文件

#include <Windows.h>

產生條件

當列表控件中的某個項目的某個字段的虛擬標籤重繪時，且列表控件響應了本消息，就會當即產生本消息。

函數聲明

void CListCtrl::OnLvnGetdispinfo (

NMHDR * pNMHDR,

LRESULT * pResult

)

函數參數

pNMHDR，[輸入&輸出]：

輸入時，存放當前重繪的某個項目的某個字段的信息。

輸出時，存放當前重繪的某個項目的某個字段的虛擬標籤。

注意：若是要修改虛擬標籤字符串的內容，須要先調用CListCtrl::SetItemText()函數，而後再在本函數內修改。若是不先調用CListCtrl::SetItemText()函數，直接就在本函數內修改，有可能會致使列表控件顯示出來的標籤內容錯誤。

pResult，[輸入]：

本參數無心義，直接填0便可。

返回值

無

錯誤碼

無

線程安全

是

原子操做

是

其餘說明

例子：

void CListCtrl:: OnLvnGetdispinfo(NMHDR *pNMHDR, LRESULT *pResult)

{

NMLVDISPINFO * pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);

pDispInfo->item.pszText = "這是虛擬標籤的內容";

*pResult = 0;

}

本消息須要項目的標籤設置成LPSTR_TEXTCALLBACK宏才能產生。

2.14.9 CIPAddressCtrl IP地址控件類

2.14.9.1 CIPAddressCtrl::GetAddress(未完成)

函數名稱	GetAddress
頭文件	#include <xxx.h> #include <xxx.h>
庫文件	#pragma comment(lib, "xxx.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.15 消息機制

Windows下的應用程序若是要接收消息，首先須要調用GetMessage()函數或PeekMessage()函數來建立一個線程消息隊列，用來存放該線程接收到的各類消息。

消息分兩種，一種是進隊消息，一種是不進隊消息。

進隊消息是指會被放入線程消息隊列的消息。例如PostMessage()函數和PostThreadMesssge()函數發送的消息，應用程序須要調用GetMessage()函數或PeekMessage()函數來獲取。

不進隊消息是指操做系統直接調用窗口過程函數所處理的消息，不會被放入線程消息隊列，沒有窗口的線程是收不到這類消息的。例如，調用SendMessage()函數發送的消息，調用CreateWindow()函數建立窗口時自動發送的WM_CREATE消息，調用UpdateWindow()函數更新窗口時自動發送的WM_PAINT消息，調用DestroyWindow()函數銷燬窗口時自動發送的WM_DESTROY消息等都是不進隊消息。

UIPI是指User Interface Privilege Isolation（用戶界面特權隔離），是Windows NT 6.0後(即Vista)引入的一種新的安全特性，是整個UAC機制的有機組成部分，主要用於攔截接受對自身進程MIC等級還低的進程發來的消息。

根據Windows開發規範，用戶自定義消息都是大於WM_USER的。UIPI的默認規則是：一個進程若是向高於本身MIC等級的進程發送高於WM_USER的消息都會失敗，而系統自定義消息則會進行選擇性的過濾，某些容易引發危險的信息也會被過濾，好比WM_DROPFILES消息。

上面提到UIPI是基於進程的MIC等級的，而在Windows NT6.0之後的系統裏面，由低到高一共分爲六個等級：

SECURITY_MANDATORY_UNTRUSTED_RID 不信任的MIC等級

SECURITY_MANDATORY_LOW_RID 低MIC等級，如IE瀏覽器進程

SECURITY_MANDATORY_MEDIUM_RID 中MIC等級，如Explorer桌面進程

SECURITY_MANDATORY_HIGH_RID 高MIC等級，以管理員身份運行的都是這個等級

SECURITY_MANDATORY_SYSTEM_RID 系統MIC等級，服務應用程序

SECURITY_MANDATORY_PROTECTED_PROCESS_RID 受保護進程的MIC等級

這裏能夠看到IE是低MIC等級的，主要是爲了在必定程度上解決IE的安全性問題，即便不少病毒經過IE下來，可是因爲自己是經過IE系統，相應的MIC等級太低，能夠防止他對其餘進程形成不良影響。

UIPI的引進能夠比較有效的解決一些和窗口消息相關的安全性問題，好比窗口粉碎攻擊，惡意窗口信息等，但也帶來了必定的兼容性問題：

1.以往經過窗口消息進行進程通訊的程序很容易碰到這樣那樣的問題。

2.運行在高MIC等級上的進程沒法接受一些經常使用的系統信息，如前面提到的文件拖曳消息。

2.15.1 消息發送

2.15.1.1 SendMessage(未完成)

函數名稱	SendMessage
頭文件	#include <Windows.h>
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.15.1.2 PostMessage(未完成)

函數名稱	PostMessage
頭文件	#include <Windows.h>
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	當發送的消息被UIPI用戶界面特權隔離阻止了，本函數會返回失敗，並設置錯誤碼爲5（拒絕訪問）。默認狀況下消息隊列的最大長度爲10000條，若是有程序收到的消息條數超過了該限制，須要考慮從新設計程序，或者修改如下注冊表項： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\Windows\USERPostMessageLimit 消息隊列的最大長度至少爲4000。

2.15.1.3 PostThreadMessage(未完成)

函數名稱	PostThreadMessage
頭文件	#include <Windows.h>
函數功能	發送一個消息到指定的線程標識對應的線程消息隊列，並當即返回，不會等待消息接收方處理完畢再返回。
函數聲明	BOOL PostThreadMessage ( DWORD idThread, UINT Msg, WPARAM wParam, LPARAM lParam );
函數參數	idThread，[輸入]：存放消息接收方的線程標識，接收方的線程必須已經建立了線程消息隊列，不然本函數返回失敗。
	Msg，[輸入]：存放消息值。
	wParam，[輸入]：存放消息的第一個參數。
	lParam，[輸入]：存放消息的第二個參數。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	ERROR_INVALID_THREAD_ID宏：接收方的線程標識是無效的，或者沒有建立線程消息隊列。 ERROR_NOT_ENOUGH_QUOTA宏：接收方的消息隊列已達到最大值。
線程安全	是
原子操做	是
其餘說明

2.15.2 消息獲取

2.15.2.1 GetMessage(未完成)

函數名稱	GetMessage
頭文件	#include <Windows.h>
函數功能	本函數是從調用線程的線程消息隊列裏取得一個消息並將其存放到指定的消息結構體，獲取消息成功後，將從消息隊列中刪除該消息。若是調用線程沒有消息隊列，本函數就會自動建立。此函數能夠指定接收必定範圍的消息值。此函數不能接收其餘線程消息隊列裏的消息。此函數會一直阻塞等待直到有消息到來才返回。
函數聲明	BOOL GetMessage ( LPMSG lpMsg, HWND hWnd, UINT wMsgFilterMin, UINT wMsgFilterMax );
函數參數	lpMsg，[輸出]：存放用於存放消息的消息結構體的內存指針，參考MSG。
	hWnd，[輸入]：存放要接收哪一個窗口的窗口消息的窗口句柄，只能是調用線程建立的窗口，不能是其餘線程建立的。若是爲NULL，表示接收窗口消息或者線程消息，不僅接收窗口消息。若是爲-1，表示只接收線程消息，不接收窗口消息。
	wMsgFilterMin，[輸入]：存放要接收的最小消息值。若是最小消息值和最大消息值都爲0，就表示獲取全部消息。例如：鍵盤消息的最小消息值爲WM_KEYFIRST(0x0100)，鼠標消息的最小消息值爲WM_MOUSEFIRST (0x0200)，若是隻想獲取WM_INPUT消息，就把最小消息值和最大消息值都設置爲WM_INPUT(0x00FF)。
	wMsgFilterMax，[輸入]：存放要接收的最大的消息值。若是最小消息值和最大消息值都爲0，就表示獲取全部消息。例如：鍵盤消息的最大消息值爲WM_KEYLAST(0x0109)，鼠標消息的最小消息值爲WM_MOUSELAST(0x020E)，若是隻想獲取WM_INPUT消息，就把最小消息值和最大消息值都設置爲WM_INPUT(0x00FF)。
返回值	非0：成功，接收到非WM_QUIT消息。 0：成功，接收到WM_QUIT消息。 -1：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.15.2.2 PeekMessage

函數名稱	PeekMessage
頭文件	#include <Windows.h>
函數功能	本函數是從調用線程的線程消息隊列裏取得一個消息並將其存放到指定的消息結構體，獲取消息成功後，能夠指定是否從消息隊列中刪除該消息。若是調用線程沒有消息隊列，本函數就會自動建立。本函數能夠指定接收必定範圍的消息值。本函數不能接收其餘線程消息隊列裏的消息。本函數不會阻塞等待消息到來，若是線程消息隊列裏沒有符合條件的消息，本函數當即返回失敗。
函數聲明	BOOL PeekMessage ( LPMSG lpMsg, HWND hWnd, UINT wMsgFilterMin, UINT wMsgFilterMax, UINT wRemoveMsg );
函數參數	lpMsg，[輸出]：存放用於存放消息的消息結構體的內存指針。詳見MSG結構體詳解。
	hWnd，[輸入]：存放要接收哪一個窗口的窗口消息的窗口句柄，只能是調用線程建立的窗口，不能是其餘線程建立的。若是爲NULL，表示接收窗口消息或者線程消息，不僅接收窗口消息。若是爲-1，表示只接收線程消息，不接收窗口消息。
	wMsgFilterMin，[輸入]：存放要接收的最小消息值。若是最小消息值和最大消息值都爲0，就表示獲取全部消息。例如：鍵盤消息的最小消息值爲WM_KEYFIRST(0x0100)，鼠標消息的最小消息值爲WM_MOUSEFIRST (0x0200)，若是隻想獲取WM_INPUT消息，就把最小消息值和最大消息值都設置爲WM_INPUT(0x00FF)。
	wMsgFilterMax，[輸入]：存放要接收的最大的消息值。若是最小消息值和最大消息值都爲0，就表示獲取全部消息。例如：鍵盤消息的最大消息值爲WM_KEYLAST(0x0109)，鼠標消息的最小消息值爲WM_MOUSELAST(0x020E)，若是隻想獲取WM_INPUT消息，就把最小消息值和最大消息值都設置爲WM_INPUT(0x00FF)。
	wRemoveMsg，[輸入]：存放要如何接收消息的標記。能夠爲（用'\|'選零至多個）： PM_NOREMOVE（0）：本函數接收到消息後，不從隊列裏刪除該消息。本標記不能與PM_REMOVE標記同時使用。 PM_REMOVE（1）：本函數接收到消息後，要從隊列裏刪除該消息。本標記不能與PM_NOREMOVE標記同時使用。 PM_NOYIELD（2）：本標誌使系統不釋放等待調用程序空閒的線程。可將本標記隨意組合到PM_NOREMOVE或PM_REMOVE標記。默認狀況下，本函數接收全部消息，也能夠指定一下類型進行接收（用'\|'選零至多個）： PM_QS_INPUT：接收鼠標和鍵盤消息。 PM_QS_PAINT：接收畫圖消息。 PM_QS_POSTMESSAGE：接收全部Post寄送方式發送的消息，包括WM_TIMER計時器和WM_HOTKEY熱鍵。 PM_QS_SENDMESSAGE：接收全部Send發送方式發送的消息。
返回值	非0：成功。 0：失敗，沒有獲取到符合條件的消息。
錯誤碼	無。
線程安全	是
原子操做	是
其餘說明

2.15.2.3 WaitMessage(未完成)

函數名稱	WaitMessage
頭文件	#include <Winuser.h>
庫文件	#pragma comment(lib, "User32.lib")
函數功能	當一個線程沒有消息在其消息隊列中的時候，線程放棄控制權給其餘的線程。WaitMessage函數掛起線程，直到一個新的消息被放入線程的消息隊列中才返回。
函數聲明	BOOL WaitMessage ( void );
函數參數	無
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	線程在調用一個函數覈查線程消息隊列後，若是消息隊列中沒有可讀的消息，WaitMessage函數不會返回。這是由於PeekMessage、GetMessage、GetQueueStatus、WaitMessage、 MsgWaitForMultipleObjects和MsgWaitForMultipleObjectsEx這樣的函數覈對消息隊列，改變隊列的狀態信息這樣輸入再也不被認爲是新的。若是連續調用WaitMessage將等到指定類型的新輸入到達後才返回。已存在的未讀過的輸入（在上次線程檢查隊列以前接收的）被忽略。

2.15.3 消息處理

2.15.3.1 鼠標

2.15.3.1.1 WM_MOUSEMOVE

消息名稱	WM_MOUSEMOVE(0x0200)
函數名稱	OnMouseMove
頭文件	#include <Windows.h>
產生條件	當鼠標在窗口的客戶區上方移動時，就會當即產生本消息。當鼠標在窗口的標題欄上方移動時，則不產生本消息。當鼠標停留在窗口上不移動時，則不產生本消息。當鼠標在其餘窗口上移動時，則不產生本消息。
函數聲明	void OnMouseLeave ( UINT nFlags, CPoint point );
函數參數	nFlags，[輸出]：存放產生本消息時各個虛擬鍵有沒有被按下，可能包含多個下列值： MK_CONTROL(0x0008)： CTRL鍵被按下。 MK_LBUTTON(0x0001)：鼠標左鍵被按下。 MK_MBUTTON(0x0010)：鼠標中鍵被按下。 MK_RBUTTON(0x0002)：鼠標右鍵被按下。 MK_SHIFT(0x0004)： SHIFT鍵被按下。 MK_XBUTTON1(0x0020)：第一個X按鈕被按下。 MK_XBUTTON2(0x0040)：第二個X按鈕被按下。
函數參數	point，[輸出]：存放產生本條消息時的鼠標位置的結構體，不是接收本消息時的座標，由於從消息的發送到接收是須要時間的。
返回值	無
其餘說明	鼠標是否在窗口的客戶區，是根據WM_NCHITTEST消息處理後的返回值來判斷的，若是WM_NCHITTEST消息處理很差，有可能會致使窗口接收不到本消息。

2.15.3.1.2 WM_MOUSELEAVE

消息名稱

WM_MOUSELEAVE(0x02A3)

函數名稱

OnMouseLeave

頭文件

#include <Windows.h>

產生條件

首先須要調用TrackMouseEvent()函數將窗口設置爲須要接收本消息，當鼠標不在窗口上方時，就會當即產生本消息，不管鼠標是不是從窗口上移動出去的。

函數聲明

void OnMouseLeave (

void

);

函數參數

無

返回值

無

其餘說明

調用TrackMouseEvent()函數將窗口設置爲須要處理本消息。例子：

TRACKMOUSEEVENT stTME;

stTME.cbSize = sizeof (stTME);//指定TRACKMOUSEEVENT結構體大小

stTME.dwFlags = TME_LEAVE;//指定須要處理WM_MOUSELEAVE消息

stTME.hwndTrack = m_hWnd;//指定要處理消息的窗口句柄

TrackMouseEvent (&stTME);//設置WM_MOUSELEAVE消息須要被處理

本消息在處理後，就不會再產生了，須要再次調用TrackMouseEvent()函數將窗口設置爲須要處理本消息。

建議在WM_MOUSEMOVE消息處理函數中調用TrackMouseEvent()函數，由於這個時候正好鼠標在窗口上方，一旦鼠標移動出去，就會產生本消息。

不建議在本消息處理函數中調用TrackMouseEvent()函數，由於一旦鼠標不在窗口上方時，就會不停的產生本消息，而且即便鼠標再移動到窗口上方，仍是會不停的產生本消息。

2.15.3.1.3 WM_LBUTTONDOWN

消息名稱	WM_LBUTTONDOWN(0x0201)
函數名稱	OnLButtonDown
頭文件	#include <Windows.h>
產生條件	當鼠標在窗口的客戶區上方按下左鍵時，就會當即產生本消息，不是左鍵彈起時。
函數聲明	void OnLButtonDown ( UINT nFlags, CPoint point );
函數參數	nFlags，[輸出]：存放產生本消息時各個虛擬鍵有沒有被按下，可能包含多個下列值： MK_CONTROL(0x0008)： CTRL鍵被按下。 MK_LBUTTON(0x0001)：鼠標左鍵被按下。 MK_MBUTTON(0x0010)：鼠標中鍵被按下。 MK_RBUTTON(0x0002)：鼠標右鍵被按下。 MK_SHIFT(0x0004)： SHIFT鍵被按下。 MK_XBUTTON1(0x0020)：第一個X按鈕被按下。 MK_XBUTTON2(0x0040)：第二個X按鈕被按下。
函數參數	point，[輸出]：存放產生本條消息時的鼠標位置的結構體，不是接收本消息時的座標，由於從消息的發送到接收是須要時間的。
返回值	無
其餘說明	左鍵彈起的時候會產生WM_LBUTTONUP消息。

2.15.3.2 註銷、重啓、關機

2.15.3.2.1 WM_QUERYENDSESSION

消息名稱	WM_QUERYENDSESSION(0x0011)
函數名稱	OnQueryEndSession
頭文件	#include <Windows.h>
產生條件	當系統在註銷、重啓、關機以前，就會當即產生本消息。本消息主要用於系統詢問各個進程，系統是否能繼續進行註銷、重啓、關機。
函數聲明	BOOL OnQueryEndSession( );
函數參數	無
返回值	非0：贊成系統繼續進行註銷、重啓、關機。 0：不一樣意系統繼續進行註銷、重啓、關機。
其餘說明	若是當前全部進程處理本消息後所有返回非0值，則系統的註銷、重起、關機將繼續下去，而且向全部進程再發送WM_ENDSESSION消息，而且消息參數bEnding爲TRUE。若是當前有一個進程處理本消息後返回0值，則系統的註銷、重起、關機將被終止，而且再也不繼續對剩餘的進程發送本消息，而是向已經發送過本消息的進程發送WM_ENDSESSION消息，而且消息參數bEnding爲FALSE。若是要判斷系統是否真的要註銷、重起、關機，只要處理WM_ENDSESSION消息，並在根據消息參數bEnding是否爲TRUE，來判斷系統是否真的要註銷、重起、關機，而後作出相應的處理。

2.15.3.3 分辨率

2.15.3.3.1 WM_DISPLAYCHANGE

消息名稱	WM_DISPLAYCHANGE(0x007E)
函數名稱	WindowProc
頭文件	#include <Windows.h>
產生條件	當系統改變屏幕的分辨率後，就會當即產生本消息。本消息只能在重載的WindowProc()函數中進行處理。
函數聲明	無
函數參數	wParam，[輸出]：存放每一個像素所佔的顏色位數的值，例如：24表示24位色，32表示32位色。
函數參數	lParam，[輸出]：存放新分辨率的水平和垂直長度的值，低字節部分爲新的水平分辨率，高字節部分爲的新的垂直分辨率。
返回值	無
其餘說明

2.15.3.4 窗口位置、窗口大小

2.15.3.4.1 WM_SIZING

消息名稱	WM_SIZING(0x0214)
函數名稱	OnSizing
頭文件	#include <Windows.h>
產生條件	當窗口的左邊、頂邊、右邊、底邊的長度將要改變但尚未改變時，就會當即產生本消息，當整個窗口被移動時，則不產生。通常是用戶正在拖動窗口的邊框時，就會當即產生本消息。
函數聲明	void OnSizing ( UINT fwSide, LPRECT pRect );
函數參數	fwSide，[輸出]：存放產生本消息時窗口的哪條邊或哪一個角被拖動，能夠爲（選一至一個）： WMSZ_BOTTOM(0x0006)：底邊被拖動。 WMSZ_BOTTOMLEFT(0x0007)：底邊和左邊被拖動，也就是左下角。 WMSZ_BOTTOMRIGHT(0x0008)：底邊和右邊被拖動，也就是右下角。 WMSZ_LEFT(0x0001)：左邊被拖動。 WMSZ_RIGHT(0x0002)：右邊被拖動。 WMSZ_TOP(0x0003)：頂邊被拖動。 WMSZ_TOPLEFT(0x0004)：頂邊和左邊被拖動，也就是左上角。 WMSZ_TOPRIGHT(0x0005)：頂邊和右邊被拖動，也就是右上角。
函數參數	pRect，[輸入&輸出]：輸入時，存放產生本條消息時，窗口大小將要改變後的位置結構體的內存指針。輸出時，存放產生本條消息後，窗口大小實際改變後的位置結構體的內存指針。注意：程序能夠修改本參數達到控制窗口大小的目的。
返回值	無
其餘說明	產生本消息時，窗口大小實際尚未改變，調用GetWindowRect()函數獲取到的仍是沒有改變時的大小。

2.15.3.5 計時器

2.15.3.5.1 WM_TIMER(未完成)

消息名稱	WM_TIMER(0x0113)
函數名稱	OnTimer
頭文件	#include <Windows.h>
產生條件	當某個計時器的超時時間已過，就會當即產生本消息。
函數聲明	void OnTimer ( UINT_PTR nIDEvent )
函數參數	nIDEvent，[輸出]：存放超時時間已過的計時器的標識。
返回值	無
其餘說明	要觸發本消息，須要先調用SetTimer()函數。因爲本消息不是操做系統產生的，而是程序在調用GetMessage()函數和PeekMessage()函數時產生的，因此若是某個計時器的超時時間已過，可是程序沒有來得及調用GetMessage()函數和PeekMessage()函數，則將不會產生本消息。 GetMessage()函數和PeekMessage()函數產生本消息的原理就是，當發現某個計時器的超時時間點已過，而後就產生本消息，並把超時時間點設置成將來的一個時刻，這個時刻與啓動該計時器的時刻保持倍數於超時時間的增長。

2.16 WinINet（Windows Internet）互聯網協議

WinINet互聯網協議API主要支持三種協議：HTTP（Hypertext Transfer Protocol）萬維網的超文本傳輸協議、FTP（File Transfer Protocol）文件傳輸協議和GopherGopher信息查找協議。

本API只能用於客戶端鏈接服務端，不支持搭建服務器。

WinINet函數內置有簡單卻靈活的緩衝支持。從網絡接收到的任何數據都會緩存到硬盤中，而後在後續請求中被獲取。應用程序能夠控制每一個請求的緩存。對於來自服務器的HTTP請求，大多數收到的頭部也被緩存。當從緩存中爲HTTP請求獲取響應時，也會把緩存的頭部數據返回給調用者。這使得數據下載對於用戶是透明的，不管數據是來自緩存仍是來自網絡。使用永久URL緩存函數時，應用程序必須正確地分配緩衝區以獲得想要的結果。

2.16.1 解析

2.16.1.1 InternetCrackUrl(未完成)

函數名稱	InternetCrackUrl
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	解析一個URL統一資源定位器字符串，分別得到協議、用戶名、密碼、服務器地址、端口號、路徑、額外信息。
函數聲明	BOOL InternetCrackUrl ( LPCTSTR lpszUrl, DWORD dwUrlLength, DWORD dwFlags, LPURL_COMPONENTS lpUrlComponents );
函數參數	lpszUrl，[輸入]：存放URL統一資源定位器字符串的內存指針。
	dwUrlLength，[輸入]：存放URL統一資源定位器字符串的內存長度。若是lpszUrl參數以'\0'結束，該參數能夠爲0。
	dwFlags：[輸入\|輸出\|輸入&輸出]，參數說明。
	lpUrlComponents，[輸出]：存放URL_COMPONENTS結構體的內存指針，解析後的各項信息就存放在此結構體裏。
返回值	TRUE：成功。 FLASE：失敗，調用GetlastError()函數獲取錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.16.2 鏈接

2.16.2.1 InternetOpen(未完成)

函數名稱	InternetOpen
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	初始化WinINet，指定鏈接服務器的方式，而後返回HINTERNET句柄。返回的HINTERNET句柄用於建立對指定服務器的指定服務的鏈接。
函數聲明	HINTERNET InternetOpen ( LPCSTR lpszAgent, DWORD dwAccessType, LPCSTR lpszProxy, LPCSTR lpszProxyBypass, DWORD dwFlags );
函數參數	lpszAgent，[輸入]：指向一個字符串，該字符串指定應用程序或實體調用WinInet函數的名稱。此名稱用做HTTP協議用戶代理，不須要就爲NULL。
	dwAccessType，[輸入]：鏈接服務器使用的方式，能夠是（選一至一個）： INTERNET_OPEN_TYPE_DIRECT：解析全部本地主機，能夠理解爲直連。 INTERNET_OPEN_TYPE_PRECONFIG：返回註冊表中代理或直接的配置。 INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY：返回註冊表中代理或直接的配置，並防止對Microsoft Jscript 或 INS文件的使用。 INTERNET_OPEN_TYPE_PROXY：爲代理傳遞請求，除非代理提供了旁路列表且解析的名字能夠繞過代理；此時，函數使用INTERNET_OPEN_TYPE_DIRECT。
	lpszProxy，[輸入]：指定了當dwAccessType參數爲INTERNET_OPEN_TYPE_PROXY時，此參數表示代理服務器的名字。不要使用一個空的字符串，由於，該函數將使用它做爲代理的名字。WinINet函數僅能識別OERN類型的代理和TIS網關。若是有安裝IE，這些函數也一樣支持SOCKS代理。FTP請求可由CERN類型代理或轉換爲HTTP請求，或使用InternetOpenUrl函數實現。若是dwAccessType參數未被設置爲INTERNET_OPEN_TYPE_PROXY，本參數無心義，直接填NULL。
	lpszProxyBypass，[輸入]：指向一個字符串，它指定一個可選的主機名列表或IP地址，列表可包括未知元素。若是dwAccessType參數未被設置爲INTERNET_OPEN_TYPE_PROXY，本參數無心義，直接填NULL。
	dwFlags，[輸入]：其餘功能標記，能夠是（用'\|'選零至多個）： INTERNET_FLAG_ASYNC：僅能用於做用在該函數返回的句柄的子句柄上的異步請求。 INTERNET_FLAG_FROM_CACHE：不作網絡請求。全部的實體都由緩存返回。若是請求條目不在緩存中，一個適當的錯誤將返回。 INTERNET_FLAG_OFFLINE：與INTERNET_FLAG_FROM_CACHE標記同樣。
返回值	非NULL：HINTERNET句柄。 NULL：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	使用完此函數返回的HINTERNET句柄後，須要調用InternetCloseHandle()函數釋放句柄資源。

2.16.2.2 InternetConnect(未完成)

函數名稱	InternetConnect
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	使用InternetOpen()函數得到的HINTERNET句柄來鏈接指定的服務器的指定的服務，而後返回HINTERNET句柄。返回的HINTERNET句柄用於和服務器之間的具體操做。
函數聲明	HINTERNET InternetConnect ( HINTERNET hInternet, LPCSTR lpszServerName, INTERNET_PORT nServerPort, LPCSTR lpszUserName, LPCSTR lpszPassword, DWORD dwService, DWORD dwFlags, DWORD_PTR dwContext );
函數參數	hInternet，[輸入]：調用InternetOpen()函數得到的HINTERNET句柄。
	lpszServerName，[輸入]：要鏈接的服務器的IP地址或者域名。
	nServerPort，[輸入]：要鏈接的服務器的端口號，能夠自由指定，也能夠是（選一至一個）： INTERNET_DEFAULT_FTP_PORT：使用默認的FTP文件傳輸協議服務器端口21。 INTERNET_DEFAULT_GOPHER_PORT：使用默認的Gopher信息查找系統服務器端口70。注意：僅適用於Windows XP和Windows Server 2003 R2及更早的操做系統。 INTERNET_DEFAULT_HTTP_PORT：使用默認的HTTP超文本傳輸協議服務器端口80。 INTERNET_DEFAULT_HTTPS_PORT：使用默認的HTTPS安全超文本傳輸協議服務器端口443。 INTERNET_DEFAULT_SOCKS_PORT：使用默認的SOCKS防火牆安全會話轉換協議服務器端口1080。 INTERNET_INVALID_PORT_NUMBER：使用dwService參數指定的服務器使用的默認端口。
	lpszUserName，[輸入]：鏈接服務器使用的用戶名字符串。若是爲NULL，則使用默認的匿名用戶。
	lpszPassword，[輸入]：鏈接服務器使用的用戶名對應的密碼字符串。若是lpszUserName參數和此參數都爲NULL，則使用默認的匿名用戶的密碼。若是lpszUserName參數不爲NULL，但此參數爲NULL，則使用空密碼。
	dwService，[輸入]：使用什麼協議鏈接服務器，能夠是（選一至一個）： INTERNET_SERVICE_FTP： FTP文件傳輸協議。 INTERNET_SERVICE_GOPHER： Gopher信息查找系統。注意：本標記僅適用於Windows XP和Windows Server 2003 R2及更早的操做系統。 INTERNET_SERVICE_HTTP： HTTP超文本傳輸協議。
	dwFlags，[輸入]：其餘功能標記。能夠是（用'\|'選零至多個）： INTERNET_FLAG_PASSIVE：若是使用FTP文件傳輸協議協議，且使用此標記，表示使用被動模式鏈接。若是使用FTP文件傳輸協議協議，但不使用此標記，表示使用主動模式鏈接。若是不是使用FTP文件傳輸協議協議，此標記無心義。 INTERNET_FLAG_EXISTING_CONNECT：若是使用相同的必須屬性建立鏈接，會嘗試使用現有的InternetConnect句柄。這僅僅是使用FTP操做時很是有用，由於FTP是，一般在同一會話中執行多個操做的惟一協議。緩存的WinINet一個鏈接句柄句柄InternetOpen生成的每一個HINTERNET 。在InternetOpenUrl中和InternetConnect函數使用這個標記用於HTTP和FTP鏈接。
	dwContext，[輸入]： Pointer to a variable that contains an application-defined value that is used to identify the application context for the returned handle in callbacks. 不須要就填NULL。
返回值	非NULL：HINTERNET句柄。 NULL：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	使用完此函數返回的HINTERNET句柄後，須要調用InternetCloseHandle()函數斷開鏈接，並釋放句柄資源。若是使用HTTP協議鏈接，此時不會真正創建TCP套接字鏈接，只有在調用HttpSendRequest()函數後纔會創建。

2.16.3 選項

2.16.3.1 InternetSetOption(未完成)

函數名稱	InternetSetOption
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	設置一個調用InternetOpen()或InternetConnect()函數獲取的HINTERNET句柄的選項的值。
函數聲明	BOOL InternetSetOption ( HINTERNET hInternet, DWORD dwOption, LPVOID lpBuffer, DWORD dwBufferLength );
函數參數	hInternet，[輸入]：存放調用InternetOpen()或InternetConnect()函數獲取的HINTERNET句柄的值。
	dwOption，[輸入]：要設置選項，能夠是（選一至一個）： INTERNET_OPTION_CONNECT_TIMEOUT：鏈接遠端時的超時間間，單位毫秒，默認爲60000毫秒，lpBuffer參數爲unsigned long類型。 INTERNET_OPTION_SEND_TIMEOUT：發送數據時的超時時間，單位毫秒，默認爲30000毫秒，lpBuffer參數爲unsigned long類型。 INTERNET_OPTION_RECEIVE_TIMEOUT：接收數據時的超時間間，單位毫秒，默認爲30000毫秒，lpBuffer參數爲unsigned long類型。更多選項參考http://technet.microsoft.com/zh-cn/sysinternals/aa385328。
	lpBuffer，[輸入]：存放要設置的選項的值的內存指針，具體類型根據dwOption參數而定。
	dwBufferLength，[輸入]：存放選項的值的內存長度，單位字節。
返回值	TRUE：成功。 FALSE：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.16.3.2 InternetQueryOption(未完成)

函數名稱	InternetQueryOption
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	查看一個調用InternetOpen()或InternetConnect()函數獲取的HINTERNET句柄的選項的值。
函數聲明	BOOL InternetQueryOption ( HINTERNET hInternet, DWORD dwOption, LPVOID lpBuffer, LPDWORD lpdwBufferLength );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.16.4 FTP文件傳輸協議

2.16.4.1 目錄操做

FtpCreateDirectory在FTP服務器上創建目錄，須要InternetConnect返回的會話句柄

FtpRemoveDirectory在FTP服務器上刪除目錄，須要InternetConnect返回的會話句柄

FtpGetCurrentDirectory獲取當前在FTP服務器上的工做目錄，須要InternetConnect返回的會話句柄

FtpSetCurrentDirectory設置在FTP服務器上的工做目錄，須要InternetConnect返回的會話句柄

2.16.4.2 文件操做

2.16.4.2.1 FtpGetFile(未完成)

函數名稱	FtpGetFile
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	從FTP服務器上下載指定文件到本地的指定文件。
函數聲明	BOOL FtpGetFile( HINTERNET hConnect, LPCTSTR lpszRemoteFile, LPCTSTR lpszNewFile, BOOL fFailIfExists, DWORD dwFlagsAndAttributes, DWORD dwFlags, DWORD_PTR dwContext );
函數參數	hConnect，[輸入]：存放調用InternetConnect()函數返回的FTP服務器鏈接句柄。
	lpszRemoteFile，[輸入]：存放要從FTP服務器上下載的指定文件的路徑字符串的內存指針。
	lpszNewFile，[輸入]：存放要下載文件到本地的指定文件的路徑字符串的內存指針。
	fFailIfExists，[輸入]：存放當本地的指定文件已存在時是否失敗的值。若是爲非0，表示不替換已存在的文件，返回失敗。若是爲0，表示替換已存在的文件。
	dwFlagsAndAttributes，[輸入]：存放本地的指定文件的文件屬性，能夠是FILE_ATTRIBUTE_*宏。
	dwFlags，[輸入]：存放下載文件時的標記。如下是傳輸模式的標記，能夠是（選一至一個）： FTP_TRANSFER_TYPE_UNKNOWN宏(0x0000)：用未知模式傳輸文件，其實就是二進制模式。 FTP_TRANSFER_TYPE_ASCII宏(0x0001)：用ASCII模式傳輸文件，將文件中的回車換行符轉換爲本機的字符。例如：UNIX系統的回車換行符爲'\n'，而Windows系統的回車換行符爲'\r\n'，用此模式能夠自動轉換這些字符。 FTP_TRANSFER_TYPE_BINARY宏(0x0002)：用二進制模式傳輸文件，不將文件中的任何字符進行轉換，保證文件的內容不會改變。 INTERNET_FLAG_TRANSFER_ASCII宏(0x0001)：用ASCII模式傳輸文件，同FTP_TRANSFER_TYPE_ASCII宏。 INTERNET_FLAG_TRANSFER_BINARY宏(0x0002)：用二進制模式傳輸文件，同FTP_TRANSFER_TYPE_BINARY宏。如下是傳輸方式的標記，能夠是（用'\|'選零至多個）： INTERNET_FLAG_NEED_FILE宏(0x0010)：若是文件不能被緩存，則建立一個臨時文件。 INTERNET_FLAG_HYPERLINK宏(0x0400)：當決定什麼時候從網絡重載時，若是服務器沒有返回Expires time和LastModified，那麼強制重載。 INTERNET_FLAG_RESYNCHRONIZE宏(0x0800)：有條件地從互聯網下載請求的資源。若是緩存中的數據就是當前版本，則使用緩存中的數據；不然，從新從服務器下載資源。 INTERNET_FLAG_RELOAD宏(0x80000000)：強制程序直接從互聯網獲取請求的資源，不從緩存中獲取，下載的信息又將從新被保存到緩存中。注意：若是容許從緩存中獲取的資源，可能會致使獲取到的資源和服務器上的資源不一致。
	dwContext，[輸入]：存放用於接收狀態信息的回調函數的函數指針。不須要就填NULL。
返回值	非0：成功。 0：失敗，調用GetlastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	網絡很差的狀況下本函數有可能出現卡住不返回的狀況，設置超時時間可能能夠解決。本函數存在下載成功，但實際下載的文件的長度與FTP上的文件的長度不一樣的狀況，出現後，若是當即從新下載此文件頗有可能文件長度仍是不一樣，因此建議先刪除損壞的文件，繼續下載其餘文件，等下載完後，斷開鏈接，再重連，再下載。

2.16.4.2.2 FtpPutFile(未完成)

函數名稱	FtpPutFile
頭文件	#include <Wininet.h>
庫文件	#pragma comment(lib, "Wininet.lib")
函數功能	把本地的指定文件上傳到FTP服務器的指定文件。
函數聲明	BOOL FtpPutFile ( HINTERNET hConnect, LPCTSTR lpszLocalFile, LPCTSTR lpszNewRemoteFile, DWORD dwFlags, DWORD_PTR dwContext );
函數參數	hConnect，[輸入]：存放調用InternetConnect()函數返回的FTP服務器鏈接句柄。
	lpszLocalFile，[輸入]：存放上傳前本地的指定文件的路徑字符串的內存指針，包括文件名。
	lpszNewRemoteFile，[輸入]：存放上傳後FTP服務器的指定文件的路徑字符串的內存指針，包括文件名。
	dwFlags，[輸入]：存放上傳文件時的標記。如下是傳輸模式的標記，能夠是（選一至一個）： FTP_TRANSFER_TYPE_UNKNOWN宏(0x0000)：用未知模式傳輸文件，就是二進制模式。 FTP_TRANSFER_TYPE_ASCII宏(0x0001)：用ASCII模式傳輸文件，將文件中的回車換行符轉換爲本機的字符。例如：UNIX系統的回車換行符爲'\n'，而Windows系統的回車換行符爲'\r\n'，用此模式能夠自動轉換這些字符。 FTP_TRANSFER_TYPE_BINARY宏(0x0002)：用二進制模式傳輸文件，不將文件中的任何字符進行轉換，保證文件的內容不會改變。 INTERNET_FLAG_TRANSFER_ASCII宏(0x0001)：用ASCII模式傳輸文件，同FTP_TRANSFER_TYPE_ASCII。 INTERNET_FLAG_TRANSFER_BINARY宏(0x0002)：用二進制模式傳輸文件，同FTP_TRANSFER_TYPE_BINARY。如下是傳輸方式的標記，能夠是（用'\|'選零至多個）： INTERNET_FLAG_NEED_FILE宏(0x0010)：若是文件不能被緩存，則建立一個臨時文件。 INTERNET_FLAG_HYPERLINK宏(0x0400)：當決定什麼時候從網絡重載時，若是服務器沒有返回Expires time和LastModified，那麼強制重載。 INTERNET_FLAG_RESYNCHRONIZE宏(0x0800)：有條件地從互聯網下載請求的資源。若是緩存中的數據就是當前版本，則使用緩存中的數據；不然，從新從服務器下載資源。 INTERNET_FLAG_RELOAD宏(0x80000000)：強制程序直接從互聯網獲取請求的資源，不從緩存中獲取，下載的信息又將從新被保存到緩存中。注意：從緩存中獲取的資源，可能會和服務器上的資源不一致。
	dwContext，[輸入]： Pointer to a variable that contains the application-defined value that associates this search with any application data. This parameter is used only if the application has already called InternetSetStatusCallback to set up a status callback. 不須要就填NULL。
返回值	非0：成功。 0：失敗，調用GetlastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.16.4.2.3 FtpDeleteFile(未完成)

函數名稱	FtpDeleteFile
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	在FTP服務器上刪除指定的文件。
函數聲明	BOOL FtpDeleteFile ( HINTERNET hConnect, LPCTSTR lpszFileName );
函數參數	hConnect，[輸入]：存放調用InternetConnect()函數返回的FTP服務器鏈接句柄。
函數參數	lpszFileName，[輸入]：存放要刪除的文件的路徑字符串的內存指針。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

FtpFindFirstFile在FTP服務器上查找符合條件的文件或目錄，須要InternetConnect返回的會話句柄

InternetFindNextFile在FTP服務器上繼續查找下一個符合條件的文件或目錄，須要FtpFindFirstFile返回的會話句柄

FtpGetFileEx

FtpDeleteFile在FTP服務器上刪除一個文件，須要InternetConnect返回的會話句柄

FtpRenameFile在FTP服務器上更改一個文件的名字，須要InternetConnect返回的會話句柄

FtpOpenFile在FTP服務器上打開一個文件，須要InternetConnect返回的會話句柄

InternetReadFile直接在FTP服務器上讀取文件，須要FtpOpenFile返回的會話句柄

InternetWriteFile直接在FTP服務器上寫入文件，須要FtpOpenFile返回的會話句柄

2.16.5 HTTP超文本傳輸協議

2.16.5.1 HttpOpenRequest(未完成)

函數名稱	HttpOpenRequest
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	建立一個HTTP請求，返回該HTTP請求的HINTERNET句柄。
函數聲明	HINTERNET HttpOpenRequest ( HINTERNET hConnect, LPCTSTR lpszVerb, LPCTSTR lpszObjectName, LPCTSTR lpszVersion, LPCTSTR lpszReferer, LPCTSTR * lplpszAcceptTypes, DWORD dwFlags, DWORD_PTR dwContext );
函數參數	hConnect，[輸入]：存放調用InternetConnect()函數鏈接HTTP服務器後，返回的HINTERNET句柄。 lpszVerb，[輸入]：存放請求名稱字符串的內存指針，爲NULL就表示GET請求。例如："GET"，"POST"等。 lpszObjectName，[輸入]：存放請求的目標對象的名稱字符串的內存指針。通常是一個網頁文件路徑，一個可執行模塊名稱，一個搜索說明符等。 lpszVersion，[輸入]：存放請求使用的HTTP協議版本字符串的內存指針，爲NULL就表示HTTP/1.1版本。例如："HTTP/1.0"，"HTTP/1.1"。 lpszReferer，[輸入]：存放HTTP Referer的URL統一資源定位器字符串的內存指針。HTTP Referer是指當瀏覽器向HTTP服務器發送請求的時候，通常會帶上Referer，告訴服務器我是從哪一個頁面連接過來的，服務器藉此能夠得到一些信息用於處理。好比從我主頁上連接到一個朋友那裏，他的HTTP服務器就可以從HTTP Referer中統計出天天有多少用戶單擊我主頁上的連接訪問他的網站。 lplpszAcceptTypes，[輸入]：存放本次請求能夠接收的文件類型列表，爲表示只接收文本文件。例如："/"表示能夠接收全部的文件類型，"text/"表示只接收文本文件。 dwFlags，[輸入]：存放請求使用的一些標記，能夠是（用'\|'選零至多個）： INTERNET_FLAG_CACHE_IF_NET_FAIL：Returns the resource from the cache if the network request for the resource fails due to an ERROR_INTERNET_CONNECTION_RESET (the connection with the server has been reset) or ERROR_INTERNET_CANNOT_CONNECT (the attempt to connect to the server failed). INTERNET_FLAG_HYPERLINK：Forces a reload if there was no Expires time and no LastModified time returned from the server when determining whether to reload the item from the network. INTERNET_FLAG_IGNORE_CERT_CN_INVALID：Disables checking of SSL/PCT-based certificates that are returned from the server against the host name given in the request. WinINet functions use a simple check against certificates by comparing for matching host names and simple wildcarding rules. INTERNET_FLAG_IGNORE_CERT_DATE_INVALID：Disables checking of SSL/PCT-based certificates for proper validity dates. INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP：Disables detection of this special type of redirect. When this flag is used, WinINet functions transparently allow redirects from HTTPS to HTTP URLs. INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS：Disables detection of this special type of redirect. When this flag is used, WinINet functions transparently allow redirects from HTTP to HTTPS URLs. INTERNET_FLAG_KEEP_CONNECTION：Uses keep-alive semantics, if available, for the connection. This flag is required for Microsoft Network (MSN), NT LAN Manager (NTLM), and other types of authentication. INTERNET_FLAG_NEED_FILE：Causes a temporary file to be created if the file cannot be cached. INTERNET_FLAG_NO_AUTH：Does not attempt authentication automatically. INTERNET_FLAG_NO_AUTO_REDIRECT：Does not automatically handle redirection in HttpSendRequest. INTERNET_FLAG_NO_CACHE_WRITE：Does not add the returned entity to the cache. INTERNET_FLAG_NO_COOKIES：Does not automatically add cookie headers to requests, and does not automatically add returned cookies to the cookie database. INTERNET_FLAG_NO_UI：Disables the cookie dialog box. INTERNET_FLAG_PRAGMA_NOCACHE：Forces the request to be resolved by the origin server, even if a cached copy exists on the proxy. INTERNET_FLAG_RELOAD：Forces a download of the requested file, object, or directory listing from the origin server, not from the cache. INTERNET_FLAG_RESYNCHRONIZE:Reloads HTTP resources if the resource has been modified since the last time it was downloaded. All FTP resources are reloaded. Windows XP and Windows Server 2003 R2 and earlier:Gopher resources are also reloaded. INTERNET_FLAG_SECURE：Uses secure transaction semantics. This translates to using Secure Sockets Layer/Private Communications Technology (SSL/PCT) and is only meaningful in HTTP requests. dwContext*，[輸入]：參數說明。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	本函數只是建立HTTP請求，並無將HTTP請求發送到HTTP服務器，須要調用HttpSendRequest()完成發送。

2.16.5.2 HttpSendRequest(未完成)

函數名稱	HttpSendRequest
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	根據調用HttpOpenRequest()函數獲取的HTTP請求的HINTERNET句柄，發送該HTTP請求到HTTP服務器。
函數聲明	BOOL HttpSendRequest ( HINTERNET hRequest, LPCTSTR lpszHeaders, DWORD dwHeadersLength, LPVOID lpOptional, DWORD dwOptionalLength );
函數參數	參數1：[輸入\|輸出\|輸入&輸出]，參數說明。參數2：[輸入\|輸出\|輸入&輸出]，參數說明。 ……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.16.6 斷開

2.16.6.1 InternetCloseHandle(未完成)

函數名稱	InternetCloseHandle
頭文件	#include <Windows.h> #include <Wininet.h> #pragma comment(lib, "wininet.lib")
函數功能	斷開與服務器的鏈接，並釋放調用InternetOpen()函數或InternetConnect()函數得到的HINTERNE句柄資源。
函數聲明	BOOL InternetCloseHandle ( HINTERNET hInternet );
函數參數	hInternet，[輸入]：存放調用InternetOpen()函數或InternetConnect()函數得到的HINTERNET句柄。
返回值	0：失敗，調用GetLastError()函數查看錯誤碼。非0：成功。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明

2.17 INI配置文件

2.17.1 INI配置文件簡介

爲何要用INI文件？若是咱們程序沒有任何配置文件時，這樣的程序對外是全封閉的，一旦程序須要修改一些參數必需要修改程序代碼自己並從新編譯，這樣很很差，因此要用配置文件，讓程序出廠後還能根據須要進行必要的配置；配置文件有不少如INI配置文件，XML配置文件，還有就是能夠使用系統註冊表等。

本文主要是爲讀者在實現讀寫INI配置文件模塊以前，提供有關INI文件的格式信息。

在早期的windows桌面系統中主要是用INI文件做爲系統的配置文件，從win95之後開始轉向使用註冊表，可是還有不少系統配置是使用INI文件的。其實INI文件就是簡單的text文件，只不過這種txt文件要遵循必定的INI文件格式。如今的WINCE系統上也經常用INI文件做爲配置文件，此次研究INI文件的目的就是爲了個人GPS定位系統客戶端寫個系統配置文件。「.INI 」就是英文「initialization」的頭三個字母的縮寫；固然INI file的後綴名也不必定是".ini"也能夠是".cfg"，".conf 」或者是".txt"。

經典格式：

INI文件的格式很簡單，最基本的三個要素是：parameters，sections和comments。

什麼是parameters元素？

INI所包含的最基本的「元素」就是parameter；每個parameter都有一個name和一個value，name和value是由等號「=」隔開。name在等號的左邊。

如：

name = value

什麼是sections章節？

全部的parameters都是以sections爲單位結合在一塊兒的。全部的section名稱都是獨佔一行，而且sections名字都被方括號包圍着（[ and ])。在section聲明後的全部parameters都是屬於該section。對於一個section沒有明顯的結束標誌符，一個section的開始就是上一個section的結束，或者是end of the file。Sections通常狀況下不能被nested，固然特殊狀況下也能夠實現sections的嵌套。

section以下所示：

[section]

什麼是comments註釋？

在INI文件中註釋語句是以分號「；」開始的。全部的全部的註釋語句無論多長都是獨佔一行直到結束的。在分號和行結束符之間的全部內容都是被忽略的。

註釋實例以下：

; comments text

固然，上面講的都是最經典的INI文件格式，隨着使用的需求INI文件的格式也出現了不少變種；

INI實例：

; last modified 1 April 2001 by John Doe

[owner] name=John Doe

organization=Acme Products

[database]

server=192.0.2.42

; use IP address in case network name resolution is not working

port=143

file = "acme payroll.dat"

2.17.2 WritePrivateProfileString(未完成)

函數名稱	WritePrivateProfileString
頭文件	#include <Windows.h>
函數功能	向指定的INI配置文件的指定章節下的指定節點寫入指定的字符串值，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	BOOL WritePrivateProfileString ( LPCSTR lpAppName, LPCSTR lpKeyName, LPCSTR lpString, LPCSTR lpFileName );
函數參數	lpAppName，[輸入]：存放章節名稱字符串的內存指針。若是指定的章節不存在，會自動在INI配置文件末尾添加。
	lpKeyName，[輸入]：存放節點名稱字符串的內存指針。節點名稱中不能出現等於符號，由於每行的第一個等於符合爲節點名稱和值的分隔符，且值的內容能夠出現等於符號。若是指定的節點不存在，會自動在章節末尾添加。若是本參數爲NULL，則會刪除指定的章節和章節下的全部節點。
	lpString，[輸入]：存放值的字符串的指針。若是指定的節點已存在，會自動替換之前的值。若是本參數爲NULL，則會刪除指定的章節下的指定的節點。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針。能夠是相對或絕對路徑，包括文件名。若是INI配置文件不存在，會自動建立。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.17.3 WritePrivateProfileSection(未完成)

函數名稱	WritePrivateProfileSection
頭文件	#include <Windows.h>
函數功能	向指定的INI配置文件的指定章節下替換全部節點爲指定的節點，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	BOOL WritePrivateProfileSection ( LPCSTR lpAppName, LPCSTR lpString, LPCSTR lpFileName );
函數參數	lpAppName，[輸入]：存放章節名稱字符串的內存指針，若是指定的章節不存在，會自動在INI配置文件末尾添加。
	lpString，[輸入]：存放多個節點名稱字符串的內存指針，節點之間用'\0'字符分隔，最後一個節點用'\0\0'結束。例如："key1=value1\0key2=value2\0\0"。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，路徑字符串必須包含文件名。若是INI配置文件不存在，會自動建立。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.17.4 WritePrivateProfileStruct(未完成)

函數名稱	WritePrivateProfileStruct
頭文件	#include <Windows.h>
函數功能	向指定的INI配置文件的指定章節下的指定節點寫入指定的結構體值，用本函數寫入的結構體值只能用GetPrivateProfileStruct()函數讀取出來，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	BOOL WritePrivateProfileStruct ( LPCSTR lpszSection, LPCSTR lpszKey, LPVOID lpStruct, UINT uSizeStruct, LPCSTR szFile );
函數參數	lpszSection，[輸入]：存放章節名稱字符串的內存指針。若是指定的章節不存在，會自動在INI配置文件末尾添加。
	lpszKey，[輸入]：存放節點名稱字符串的內存指針。節點名稱中不能出現等於符號，由於每行的第一個等於符合爲節點名稱和值的分隔符，且值的內容能夠出現等於符號。若是指定的節點不存在，會自動在章節末尾添加。若是本參數爲NULL，則會刪除指定的章節和章節下的全部節點。不能爲""空字符串，不然會內存讀寫錯誤。
	lpStruct，[輸入]：存放結構體值的內存指針。若是指定的節點已存在，會自動替換之前的值。若是本參數爲NULL，則會刪除指定的章節下的指定的節點。
	uSizeStruct，[輸入]：存放結構體值的內存的長度。
	szFile，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，包括文件名。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.17.5 GetPrivateProfileSectionNames(未完成)

函數名稱	GetPrivateProfileSectionNames
頭文件	#include <Windows.h>
函數功能	從指定的INI配置文件的讀取全部的章節名稱字符串，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	DWORD GetPrivateProfileSectionNames ( LPSTR lpszReturnBuffer, DWORD nSize, LPCSTR lpFileName );
函數參數	lpszReturnBuffer，[輸出]：存放全部的章節名稱字符串的內存指針，節點之間用'\0'字符分隔，最後一個章節用'\0\0'結束。例如："Section1\0Section2\0…SectionN\0\0"。
	nSize，[輸入]：存放全部的章節名稱字符串的內存的長度。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，包括文件名。
返回值	輸出了多少字節到存放全部的章節名稱字符串的內存，包括每一個章節名稱的'\0'結束符，不包括最後一個'\0'結束符。
錯誤碼	無。
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.17.6 GetPrivateProfileSection(未完成)

函數名稱	GetPrivateProfileSection
頭文件	#include <Windows.h>
函數功能	從指定的INI配置文件的指定章節下讀取全部的節點名稱和值字符串，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	DWORD GetPrivateProfileSection ( LPCWSTR lpAppName, LPWSTR lpReturnedString, DWORD nSize, LPCWSTR lpFileName );
函數參數	lpAppName，[輸入]：存放指定的章節名稱字符串的內存指針，字符串中不區分大小寫字母。
	lpszReturnBuffer，[輸出]：存放全部的節點名稱和值字符串的內存指針，節點之間用'\0'字符分隔，最後一個節點用'\0\0'結束，例如："Key1=Value1\0Key2=Value2\0…KeyN=ValueN\0\0"。
	nSize，[輸入]：存放全部的節點名稱和值字符串的內存的長度。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，包括文件名。
返回值	非0：全部的節點名稱和值字符串的長度，包括全部的分隔符'\0'，不包括最後的'\0'結束符。若是存放全部的節點名稱和值字符串的內存不夠長，返回值就是內存的長度減2。 0：失敗，或存放全部的節點名稱和值字符串的內存的長度小於等於2。
錯誤碼	無。
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.17.7 GetPrivateProfileString(未完成)

函數名稱	GetPrivateProfileString
頭文件	#include <Windows.h>
函數功能	從指定的INI配置文件的指定章節下的指定節點讀取字符串值到指定的內存，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	DWORD GetPrivateProfileString ( LPCSTR lpAppName, LPCSTR lpKeyName, LPCSTR lpDefault, LPSTR lpReturnedString, DWORD nSize, LPCTSTR lpFileName );
函數參數	lpAppName，[輸入]：存放指定的章節名稱字符串的內存指針，字符串中不區分大小寫字母。
	lpKeyName，[輸入]：存放指定的節點名稱字符串的內存指針，字符串中不區分大小寫字母。節點名稱中不能出現等於符號，由於每行的第一個等於符合爲節點名稱和值的分隔符，且值的內容能夠出現等於符號。
	lpDefault，[輸入]：存放缺省值的內存指針。若是指定的INI配置文件或章節或節點未找到，那麼就強制用缺省值代替。若是本參數爲NULL，就表示""空字符串。
	lpReturnedString，[輸出]：存放指定節點的字符串值的內存指針。
	nSize，[輸入]：存放指定節點的字符串值的內存長度。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，包括文件名。
返回值	字符串值的長度，不包括'\0'結束符。若是讀取失敗，返回值爲0，且存放字符串值的內存的第一個字節會設置成'\0'。
錯誤碼	無。
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明	章節名稱、節點名稱、節點值先後的無心義空格在查找和獲取時都將自動去掉，例如：[Section]、[ Section]、[Section ]都表示是Section章節，key=value、key =value 、 key = value 都表示key節點的值爲value。

2.17.8 GetPrivateProfileInt(未完成)

函數名稱	GetPrivateProfileInt
頭文件	#include <Windows.h>
函數功能	從指定的INI配置文件的指定章節下的指定節點讀取非負整數值到指定的內存，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	UINT GetPrivateProfileInt ( LPCSTR lpAppName, LPCSTR lpKeyName, INT nDefault, LPCSTR lpFileName );
函數參數	lpAppName，[輸入]：存放指定的章節名稱字符串的內存指針，字符串中不區分大小寫字母。
	lpKeyName，[輸入]：存放指定的節點名稱字符串的內存指針，字符串中不區分大小寫字母。節點名稱中不能出現等於符號，由於每行的第一個等於符合爲節點名稱和值的分隔符，且值的內容能夠出現等於符號。
	nDefault，[輸入]：存放缺省值的內存指針。若是指定的INI配置文件或指定的章節或指定的節點未找到，那麼就強制用缺省值代替。
	lpFileName，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，包括文件名。
返回值	讀取到的非負整數值
錯誤碼	無
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明	章節名稱、節點名稱、節點值先後的無心義空格在查找和獲取時都將自動去掉，例如：[Section]、[ Section]、[Section ]都表示是Section章節，key=value、key =value 、 key = value 都表示key節點的值爲value。

2.17.9 GetPrivateProfileStruct(未完成)

函數名稱	GetPrivateProfileStruct
頭文件	#include <Windows.h>
函數功能	從指定的INI配置文件的指定章節下的指定節點讀取結構體值到指定的內存，結構體值必須是調用WritePrivateProfileStruct()函數寫入的，本系列函數支持多線程同時讀寫同一個INI配置文件。
函數聲明	BOOL GetPrivateProfileStruct ( LPCSTR lpszSection, LPCSTR lpszKey, LPVOID lpStruct, UINT uSizeStruct, LPCSTR szFile );
函數參數	lpszSection，[輸入]：存放指定的章節名稱字符串的內存指針，字符串中不區分大小寫字母。
	lpszKey，[輸入]：存放指定的節點名稱字符串的內存指針，字符串中不區分大小寫字母。節點名稱中不能出現等於符號，由於每行的第一個等於符合爲節點名稱和值的分隔符，且值的內容能夠出現等於符號。
	lpStruct，[輸出]：存放結構體值的內存指針。
	uSizeStruct，[輸入]：存放結構體值的內存的長度。
	szFile，[輸入]：存放INI配置文件的路徑字符串的內存指針，能夠是相對或絕對路徑，路徑字符串必須包含文件名。
返回值	非0：成功。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是，只在調用本系列函數時。
其餘說明

2.18 音頻

用CWaveFile類操做WAVE格式的文件。

waveInGetDevCaps

waveInGetErrorText

waveInGetID

waveInGetPosition

waveInMessage

waveOutBreakLoop

waveOutClose

waveOutGetDevCaps

waveOutGetErrorText

waveOutGetID

waveOutGetPitch

waveOutGetPlaybackRate

waveOutGetPosition

waveOutGetVolume

waveOutMessage

waveOutPause

waveOutPrepareHeader

waveOutReset

waveOutRestart

waveOutSetPitch

waveOutSetPlaybackRate

waveOutSetVolume

waveOutUnprepareHeader

2.18.1 輸入

2.18.1.1 waveInGetNumDevs

函數名稱	waveInGetNumDevs
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	獲取可用的音頻輸入設備的數量，不包括已禁用、已斷開的音頻輸入設備。
函數聲明	UINT waveInGetNumDevs ( void );
函數參數	無
返回值	0：沒有音頻輸入設備，或發生錯誤。其餘：音頻輸入設備的數量。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.18.1.2 waveInOpen(未完成)

函數名稱	waveInOpen
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	打開指定的音頻輸入設備，並獲取音頻輸入設備句柄。打開後，將產生WIM_OPEN消息。
函數聲明	MMRESULT waveInOpen ( LPHWAVEIN phwi, UINT uDeviceID, LPCWAVEFORMATEX pwfx, DWORD_PTR dwCallback, DWORD_PTR dwCallbackInstance, DWORD fdwOpen );
函數參數	phwi，[輸出]：存放音頻輸入設備句柄的變量的內存指針。若是fdwOpen參數爲WAVE_FORMAT_QUERY宏，本參數無心義。
	uDeviceID，[輸入]：存放設備ID，能夠是一個設備標識符或一個已打開的音頻輸入設備句柄，設備標識符應該爲從0到音頻輸入設備的數量，也能夠爲（選一至一個）： WAVE_MAPPER宏(0xFFFF)：系統自動根據指定的音頻格式結構體選擇的音頻輸入設備。
	pwfx，[輸入]：存放音頻輸入時所用的音頻格式結構體的內存指針，參考WAVEFORMATEX。
	dwCallback，[輸入]：存放指向回調函數的指針或窗口句柄，用於處理音頻輸入過程當中產生的消息。回調函數參考waveInProc。
	dwCallbackInstance，[輸入]：存放傳遞給回調函數的數據，以回調函數的參數方式傳遞。若是回調方式爲窗口方式，本參數無心義。
	fdwOpen，[輸入]：存放打開音頻輸入設備時的標記，能夠爲（選一至一個）： CALLBACK_EVENT宏： dwCallback參數爲事件句柄。 CALLBACK_FUNCTION宏：若是設置本標記，表示回調函數回調方式，dwCallback參數爲回調函數的內存指針，回調函數聲明參考waveInProc。該回調函數會一直在另一個獨立的新線程中被調用執行。 CALLBACK_THREAD宏：若是設置本標記，表示採用線程消息回調方式，dwCallback參數爲線程ID，參數類型爲DWORD。當音頻輸入設備句柄已經被調用waveInClose()函數關閉了，窗口將收到MM_WIM_OPEN消息。當音頻輸入設備已經完成一個音頻數據塊的採集，窗口將收到MM_WIM_DATA消息。當音頻輸入設備句柄已經被調用waveInOpen()函數打開了，窗口將收到MM_WOM_CLOSE消息。 CALLBACK_WINDOW宏：若是設置本標記，表示採用窗口消息回調方式，dwCallback參數爲窗口句柄，參數類型爲HWND。當音頻輸入設備句柄已經被調用waveInClose()函數關閉了，窗口將收到MM_WIM_OPEN消息。當音頻輸入設備已經完成一個音頻數據塊的採集，窗口將收到MM_WIM_DATA消息。當音頻輸入設備句柄已經被調用waveInOpen()函數打開了，窗口將收到MM_WOM_CLOSE消息。 CALLBACK_NULL宏：不使用任何回調機制。本標記是默認標記。 WAVE_MAPPED_DEFAULT_COMMUNICATION_DEVICE宏： If this flag is specified and the uDeviceID parameter is WAVE_MAPPER, the function opens the default communication device. This flag applies only when uDeviceID equals WAVE_MAPPER. Note Requires Windows 7 WAVE_FORMAT_DIRECT宏：若是設置本標記，表示經過指定的音頻輸入設備採集到的音頻數據塊結構體，不會被Abstract Control Model(ACM)驅動轉換。若是不設置本標記，表示經過指定的音頻輸入設備採集到的音頻數據塊結構體，可能會被Abstract Control Model(ACM)驅動轉換。 WAVE_FORMAT_QUERY宏：若是設置本標記，表示查詢音頻輸入設備是否支持指定的音頻格式結構體，不會打開音頻輸入設備，phwi參數將無心義，支持就會返回MMSYSERR_NOERROR宏，不支持就會返回WAVERR_BADFORMAT宏。若是不設置本標記，表示查詢音頻輸入設備是否支持指定的音頻格式結構體，並打開音頻輸入設備，phwi參數將有意義，支持並打開成功就會返回MMSYSERR_NOERROR宏，不支持就會返回WAVERR_BADFORMAT宏，或其餘錯誤。 WAVE_MAPPED宏(0x0004)： The uDeviceID parameter specifies a waveform-audio device to be mapped to by the wave mapper.
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_ALLOCATED宏(0x0004)：Specified resource is already allocated. MMSYSERR_BADDEVICEID宏(0x0002)：Specified device identifier is out of range. MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 WAVERR_BADFORMAT宏(0x0020)：嘗試打開的音頻格式不被音頻輸入設備支持。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	同一進程中，若是屢次打開同一音頻輸入設備，得到的音頻輸入設備句柄都是同樣的。

2.18.1.3 waveInProc

函數名稱	waveInProc
頭文件	#include <Mmsystem.h>
庫文件	無
函數功能	本函數爲音頻輸入設備回調函數的聲明，當音頻輸入設備被打開、關閉、完成一個音頻數據塊的採集時，系統將自動回調本函數。
函數聲明	void waveInProc ( HWAVEIN hwi, UINT uMsg, DWORD_PTR dwInstance, DWORD_PTR dwParam1, DWORD_PTR dwParam2 );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
	uMsg，[輸入]：存放音頻輸入設備的消息類型，能夠爲： WIM_CLOSE宏(0x03BF)：當音頻輸入設備句柄已經被調用waveInClose()函數關閉了，將收到本消息。 WIM_DATA宏(0x03C0)：當音頻輸入設備已經完成一個音頻數據塊的採集，將收到本消息。 WIM_OPEN宏(0x03BE)：當音頻輸入設備句柄已經被調用waveInOpen()函數打開了，將收到本消息。
	dwInstance，[輸入]：存放音頻輸入設備句柄被調用waveInOpen()函數打開時的dwCallbackInstance參數。程序能夠自由經過設置不一樣的本參數，來區分是哪個音頻輸入設備。
	dwParam1，[輸入]：存放第一個消息參數。若是uMsg參數爲WIM_DATA宏時，本參數爲已經完成採集的音頻數據塊結構體的內存指針，類型爲WAVEHDR *。若是uMsg參數爲WIM_CLOSE宏、WIM_OPEN宏時，本參數無心義。
	dwParam2，[輸入]：存放第二個消息參數，本參數無心義。
返回值	無
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.18.1.4 waveInPrepareHeader

函數名稱	waveInPrepareHeader
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	初始化音頻數據塊結構體。
函數聲明	MMRESULT waveInPrepareHeader ( HWAVEIN hwi, LPWAVEHDR pwh, UINT cbwh );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
	pwh，[輸入]：存放一個音頻數據塊結構體的內存指針，參考WAVEHDR。
	cbwh，[輸入]：存放音頻數據塊結構體的內存長度，單位指針。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 MMSYSERR_HANDLEBUSY宏(0x000C)：其餘線程正在使用該設備。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	當再也不須要使用音頻數據塊結構體時，必須調用waveInUnprepareHeader()函數釋放，不然會內存泄漏。

2.18.1.5 waveInUnprepareHeader(未完成)

函數名稱	waveInUnprepareHeader
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	釋放已經初始化的音頻數據塊結構體。
函數聲明	MMRESULT waveInUnprepareHeader ( HWAVEIN hwi, LPWAVEHDR pwh, UINT cbwh );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
	pwh，[輸入]：存放一個音頻數據塊結構體的內存指針，參考WAVEHDR。
	cbwh，[輸入]：存放音頻數據塊結構體的內存長度，單位指針。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 MMSYSERR_HANDLEBUSY宏(0x000C)：其餘線程正在使用該設備。 WAVERR_STILLPLAYING宏(0x0021)：音頻數據塊結構體還添加在音頻輸入設備上。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	要釋放的音頻數據塊結構體必須已經從音頻輸入設備上移除，不然沒法釋放。

2.18.1.6 waveInAddBuffer(未完成)

函數名稱	waveInAddBuffer
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	將已經初始化的音頻數據塊結構體添加到音頻輸入設備上。同一個音頻輸入設備上能夠添加多個音頻數據塊結構體，這樣能夠保證音頻輸入的連續性。當一個音頻數據塊結構體已經完成採集後，該結構體會自動從音頻輸入設備上移除。若是要實現連續音頻輸入，就在音頻輸入設備上添加多個音頻數據塊結構體，當某個採集好後被自動移除後，再當即添加進去，這樣音頻輸入就不會中斷，具體幾個須要本身試，通常兩個就夠。
函數聲明	MMRESULT waveInAddBuffer ( HWAVEIN hwi, LPWAVEHDR pwh, UINT cbwh );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
	pwh，[輸入]：存放一個已經調用waveInPrepareHeader()函數初始化的音頻數據塊結構體的內存指針。
	cbwh，[輸入]：存放音頻數據塊結構體的內存長度，單位指針。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 MMSYSERR_HANDLEBUSY宏(0x000C)：其餘線程正在使用該設備。 WAVERR_UNPREPARED宏(0x0022)：音頻數據塊結構體未初始化。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是再也不須要音頻輸入，需先調用waveInClose()函數中止音頻輸入，再調用waveInReset()函數移除音頻輸入設備上全部的音頻數據塊結構體。

2.18.1.7 waveInStart(未完成)

函數名稱	waveInStart
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	讓一個已經打開的音頻輸入設備句柄開始音頻輸入。當完成一個音頻數據塊的採集後，將產生WIM_DATA消息。
函數聲明	MMRESULT waveInStart ( HWAVEIN hwi );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.18.1.8 waveInStop(未完成)

函數名稱	waveInStop
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	讓一個已經開始音頻輸入的音頻輸入設備句柄中止音頻輸入。中止音頻輸入後，將再也不產生WIM_DATA消息。
函數聲明	MMRESULT waveInStop ( HWAVEIN hwi );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是音頻輸入設備正在音頻輸入，但尚未完成一個音頻數據塊的採集，則會當即中斷採集，併產生WIM_DATA消息，音頻數據塊結構體中的dwBytesRecorded成員變量將存放實際數據的內存長度。本函數不會移除尚未使用的音頻數據塊。

2.18.1.9 waveInReset(未完成)

函數名稱	waveInReset
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	讓一個已經開始音頻輸入的音頻輸入設備句柄中止音頻輸入，並將已經添加到音頻輸入設備上的全部音頻數據塊結構體所有移除。
函數聲明	MMRESULT waveInReset ( HWAVEIN hwi );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	若是音頻輸入設備正在音頻輸入，但尚未完成一個音頻數據塊的採集，則會當即中斷採集，併產生WIM_DATA消息，音頻數據塊結構體中的dwBytesRecorded成員變量將存放實際數據的內存長度。

2.18.1.10 waveInClose(未完成)

函數名稱	waveInClose
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	讓一個已經打開的播放設備句柄關閉。若是播放設備上還有音頻數據塊結構體，必須先移除，不然會致使關閉失敗。
函數聲明	MMRESULT waveInClose ( HWAVEIN hwi );
函數參數	hwi，[輸入]：存放音頻輸入設備句柄。
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_INVALHANDLE宏(0x0005)：設備句柄無效。 MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 WAVERR_STILLPLAYING宏(0x0021)：音頻輸入設備上還有音頻數據塊結構體。
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明

2.18.2 輸出

2.18.2.1 waveOutGetNumDevs

函數名稱	waveOutGetNumDevs
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	獲取可用的播放設備的數量，不獲取已禁用、已斷開的播放設備。
函數聲明	UINT waveOutGetNumDevs ( void );
函數參數	無。
返回值	0：沒有播放設備，或發生錯誤。其餘：播放設備的數量。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明

2.18.2.2 waveOutOpen(未完成)

函數名稱	waveOutOpen
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	打開指定的播放設備，並獲取播放設備句柄。打開後，將產生WOM_OPEN消息。
函數聲明	MMRESULT waveOutOpen ( LPHWAVEOUT phwo, UINT_PTR uDeviceID, LPWAVEFORMATEX pwfx, DWORD_PTR dwCallback, DWORD_PTR dwCallbackInstance, DWORD fdwOpen );
函數參數	phwo，[輸出]：存放播放設備句柄的變量的內存指針。若是fdwOpen參數爲WAVE_FORMAT_QUERY宏，本參數無心義。
	uDeviceID，[輸入]：存放設備ID，能夠是一個設備標識符或一個已打開的播放設備句柄，設備標識符應該從0到播放設備的數量，也能夠爲（選一至一個）： WAVE_MAPPER宏(0xFFFF)：系統自動根據指定的音頻格式結構體選擇的播放設備。
	pwfx，[輸入]：存放播放時所用的音頻格式結構體的內存指針，參考WAVEFORMATEX。
	dwCallback，[輸入]：存放指向回調函數的指針或窗口句柄，用於處理播放過程當中產生的消息。
	dwCallbackInstance，[輸入]：存放傳遞給回調函數的數據，以回調函數的參數方式傳遞。若是回調方式爲窗口方式，本參數無心義。
	fdwOpen，[輸入]：存放打開播放設備時的標記，能夠爲（選一至一個）： CALLBACK_EVENT宏：dwCallback參數爲事件句柄。 CALLBACK_FUNCTION宏：dwCallback參數爲回調函數的內存指針，回調函數聲明參考waveOutProc。該回調函數會一直在另一個獨立的新線程中執行。 CALLBACK_THREAD宏：dwCallback參數爲線程ID。 CALLBACK_WINDOW宏：dwCallback參數爲窗口句柄，dwCallback參數類型爲HWND。 CALLBACK_NULL宏：不使用任何回調機制。本標記是默認標記。 WAVE_ALLOWSYNC宏：If this flag is specified, a synchronous waveform-audio device can be opened. If this flag is not specified while opening a synchronous driver, the device will fail to open. WAVE_MAPPED_DEFAULT_COMMUNICATION_DEVICE宏：If this flag is specified and the uDeviceID parameter is WAVE_MAPPER, the function opens the default communication device. This flag applies only when uDeviceID equals WAVE_MAPPER. Note Requires Windows 7 WAVE_FORMAT_DIRECT宏：If this flag is specified, the ACM driver does not perform conversions on the audio data. WAVE_FORMAT_QUERY宏：The function queries the device to determine whether it supports the given format, but it does not open the device. WAVE_MAPPED宏：The uDeviceID parameter specifies a waveform-audio device to be mapped to by the wave mapper.
返回值	MMSYSERR_NOERROR宏(0x0000)：成功。 MMSYSERR_ALLOCATED宏(0x0004)：Specified resource is already allocated. MMSYSERR_BADDEVICEID宏(0x0002)：Specified device identifier is out of range. MMSYSERR_NODRIVER宏(0x0006)：沒有音頻輸入設備。 MMSYSERR_NOMEM宏(0x0007)：不能分配或鎖定內存。 WAVERR_BADFORMAT宏(0x0020)：Attempted to open with an unsupported waveform-audio format. WAVERR_SYNC宏(0x0023)：The device is synchronous but waveOutOpen was called without using the WAVE_ALLOWSYNC flag.
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.18.2.3 waveOutProc(未完成)

函數名稱	waveOutProc
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	本函數爲播放設備回調函數的聲明，當播放設備被打開、關閉、完成一個音頻數據塊的播放時，系統將自動回調本函數。
函數聲明	void waveOutProc ( HWAVEOUT hwo, UINT uMsg, DWORD_PTR dwInstance, DWORD_PTR dwParam1, DWORD_PTR dwParam2 );
函數參數	hwo，[輸入]：存放播放設備句柄。
	uMsg，[輸入]：存放播放設備的消息類型，能夠爲： WOM_CLOSE宏(0x03BF)：當播放設備句柄已經被調用waveInClose()函數關閉了，將收到本消息。 WOM_DATA宏(0x03C0)：當播放設備已經完成一個音頻數據塊的播放，將收到本消息。 WOM_OPEN宏(0x03BE)：當播放設備句柄已經被調用waveInOpen()函數打開了，將收到本消息。
	dwInstance，[輸入]：存放播放設備句柄被調用waveOutOpen()函數打開時的dwCallbackInstance參數。程序能夠自由經過設置不一樣的本參數，來區分是哪個播放設備。
	dwParam1，[輸入]：存放第一個消息參數。若是uMsg參數爲WOM_DATA宏時，本參數爲已經完成播放的音頻數據塊結構體的內存指針，類型爲WAVEHDR *。若是uMsg參數爲WOM_CLOSE宏、WOM_OPEN宏時，本參數無心義。
	dwParam2，[輸入]：存放第二個消息參數，本參數無心義。
返回值	無
錯誤碼	無
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.18.2.4 waveOutWrite(未完成)

函數名稱	waveOutWrite
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	將已經完成採集的音頻數據塊結構體添加到播放設備上，並開始播放，播放完畢後將自動移除音頻數據塊結構體。若是要實現連續播放，必須音頻數據塊結構體播放完畢並移除後，才能再次添加音頻數據塊結構體播放設備上。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.18.2.5 waveOutClose(未完成)

函數名稱	waveOutClose
頭文件	#include <Mmsystem.h>
庫文件	#pragma comment(lib, "Winmm.lib")
函數功能	函數主要功能說明。
函數聲明	類型函數名 ( 類型參數1, 類型參數2, …… );
函數參數	參數1，[輸入\|輸出\|輸入&輸出]：參數說明。
	參數2，[輸入\|輸出\|輸入&輸出]：參數說明。
	……
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.18.2.6 PlaySound

函數名稱	PlaySound
頭文件	#include <windows.h> #pragma comment(lib, "winmm.lib")
函數功能	播放音頻，音頻能夠是WAVE音頻文件、內存中的WAVE音頻數據、程序自身的WAVE資源，本函數不能讓進程同時播放兩段音頻，不一樣的進程能夠同時播放。
函數聲明	BOOL PlaySound ( LPCSTR pszSound, HMODULE hmod, DWORD fdwSound );
函數參數	pszSound，[輸入]：存放音頻數據的內存指針，具體做用根據fdwSound參數的標記而定。
	hmod，[輸入]：存放當前程序實例的句柄的值，只有當fdwSound參數的設置了SND_RESOURCE標記纔有意義，其餘狀況，此參數必須爲NULL。
	fdwSound，[輸入]：播放標記，能夠是（用'\|'選一至多個）： SND_ALIAS：設置此標記表示pszSound參數爲指定的註冊表或WIN.INI中的系統事件的別名，有些操做系統可能沒有某些事件。若是指定的系統事件不存在，就會致使播放音頻失敗。pszSound參數能夠是（選一至一個）： "SystemAsterisk"：「SystemAsterisk系統星號聲」事件。 "SystemDefault"：「SystemDefault系統默認聲」事件。 "SystemExclamation"：「SystemExclamation系統感嘆聲」事件。 "SystemExit"：「SystemExit系統退出聲」事件。 "SystemHand"：「SystemHand系統指針聲」事件。 "SystemQuestion"：「SystemQuestion系統詢問聲」事件。 "SystemStart"：「SystemStart系統啓動聲」事件。 "SystemWelcome"：「SystemWelcome系統歡迎聲」事件。 SND_ALIAS_ID：設置此標記表示pszSound參數爲指定的註冊表或WIN.INI中的系統事件的別名ID，有些操做系統可能沒有某些事件。若是指定的系統事件不存在，就會致使播放音頻失敗。pszSound參數能夠是（選一至一個）： SND_ALIAS_SYSTEMASTERISK：「SystemAsterisk系統星號音」事件。 SND_ALIAS_SYSTEMDEFAULT：「SystemDefault系統默認音」事件。 SND_ALIAS_SYSTEMEXCLAMATION：「SystemExclamation系統感嘆聲」事件。 SND_ALIAS_SYSTEMEXIT：「SystemExit系統退出聲」事件。 SND_ALIAS_SYSTEMHAND：「SystemHand系統指針聲」事件。 SND_ALIAS_SYSTEMQUESTION：「SystemQuestion系統詢問聲」事件。 SND_ALIAS_SYSTEMSTART：「SystemStart系統啓動聲」事件。 SND_ALIAS_SYSTEMWELCOME：「SystemWelcome系統歡迎聲」事件。 SND_RESOURCE：pszSound參數爲WAVE資源的標識符，hmod參數就爲WAVE資源的標識符所屬的程序實例的句柄，當前程序實例就可調用AfxGetResourceHandle()函數得到。 SND_FILENAME：pszSound參數爲指定的WAVE文件名相對或絕對路徑字符串的內存指針。 SND_MEMORY：pszSound參數爲存放音頻數據的內存指針，播放已經載入到內存中的音頻。若是同時還設置了SND_ASYNC標記，必須保證存放音頻數據的內存在播放結束前是正確的。以上標記必選一至一個。 SND_ASYNC：異步方式播放音頻，PlaySound()函數在開始播放後當即返回，不等待播放結束。 SND_SYNC：同步方式播放音頻，在播放結束後PlaySound()函數才返回。 SND_LOOP：若是設置此標記，表示不停的重複播放音頻，包括播放音頻失敗時的缺省音頻，必須與SND_ASYNC標誌同時設置；若是不設置此標記，音頻在播放一次後就結束了。 SND_APPLICATION：用應用程序指定的關聯來播放音頻，若是沒有關聯的播放程序，就會致使播放音頻失敗。 SND_NODEFAULT：若是設置此標記，當播放音頻失敗時，本函數就返回失敗；若是不設置此標記，當播放音頻失敗時，則本函數就播放缺省音頻，而且返回成功。 SND_NOSTOP：若是設置此標記，且當前進程的任意線程正在調用本函數同步或異步播放音頻，就表示不結束當前正在播放的音頻，並當即返回失敗；若是不設置此標記，且當前進程的任意線程正在調用本函數異步播放音頻，就表示當即結束當前正在播放的音頻，開始播放本函數指定的音頻，可是若是當前進程的其餘線程正在調用本函數同步播放音頻，就表示等待其餘線程同步播放結束，再開始播放本函數指定的音頻。 SND_NOWAIT：若是驅動程序正忙則函數就不播放音頻，並當即返回失敗。 SND_PURGE：中止全部與調用任務有關的音頻。若是pszSound參數爲NULL，就中止全部的音頻，不然，中止pszSound指定的音頻。
返回值	非0：成功。 0：失敗，沒法查看錯誤碼。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	此函數對多線程的調用的行爲不是很明確，因此要多線程播放音頻不推薦使用此函數。

2.19 視頻

2.20 API HOOK捕獲系統API

Detours是微軟開發的一個函數庫，可用於捕獲系統API。

2.21 異常處理

2.21.1 簡介

在C++發展的後期，有的C++編譯系統根據實際工做的須要，增長了一些功能，做爲工具來使用，其中主要有模板(包括函數模板和類模板)、異常處理、命名空間和運行時類型，以幫助程序設計人員更方便地進行程序的設計和調試工做。1997年ANSI C++委員會將它們歸入了ANSII C++標準，建議全部的C++編譯系統都能實現這些功能。這些工具是非有用的，C++的使用者應當儘可能使用這些工具，所以本書對此做簡要的介紹，以便爲往後的進一步學習和使用打下初步基礎。在本章中主要介紹異常處理和命名空間，應當注意，期的C++是不具有這些功能的，只有近期的C++系統根據ANSIC++的要求，實現了這些功能。請讀者注意使用的C++版本。

2.21.2 異常處理的目的

程序員老是但願本身所編寫的程序都是正確無誤的，並且運行結果也是徹底正確的。可是這幾乎是不可能的，智者千慮，必有一失，不怕一萬，就怕萬一。所以，程序編制者不只要考慮程序沒有錯誤的理想狀況，更要考慮程序存在錯誤時的狀況，應該可以儘快地發現錯誤，消除錯誤。

語法錯誤：

在編譯時，編譯系統能發現程序中的語法錯誤(如關鍵字拼寫錯誤，變量名未定義，語句末尾缺分號，括號不配對等)，編譯系統會告知用戶在第幾行出錯，是什麼樣的錯誤。因爲是在編譯階段發現的錯誤，所以這類錯誤又稱編譯錯誤。有的初學者寫的並不長的程序，在編譯時會出現十幾個甚至幾十個語法錯誤，有人每每感到手足無措。可是，總的來講，這種錯誤是比較容易發現和糾正的，由於它們通常都是有規律的，在有了必定的編譯經驗之後，能夠很快地發現出錯的位置和緣由並加以改正。

運行錯誤：

有的程序雖然能經過編譯，也能投入運行。可是在運行過程當中會出現異常，得不到正確的運行結果，甚至致使程序不正常終止，或出現死機現象。

例如：

．在一系列計算過程當中，出現除數爲0的狀況。

．內存空間不夠，沒法實現指定的操做。

．沒法打開輸入文件，於是沒法讀取數據。

．輸入數據時數據類型有錯。

因爲程序中沒有對此的防範措施，所以系統只好終止程序的運行。這類錯誤比較隱蔽，易被發現，每每耗費許多時間和精力，這成爲程序調試中的一個難點。

在設計程序時，應當事先分析程序運行時可能出現的各類意外的狀況，而且分別制訂出相應的處理方法，這就是程序的異常處理的目的。

須要說明：在通常狀況下，異常指的是出錯(差錯)，可是異常處理並不徹底等同於對出錯的處理。只要出現與人們指望的狀況不一樣，均可以認爲是異常，並對它進行異常處理。例如，在輸入學生學號時輸入了負數，此時程序並不出錯，也不終止運行，可是人們認爲這是不該有的學號，應予以處理。所以，所謂異常處理指的是對運行時出現的差錯以及其餘例外狀況的處理。

2.21.3 異常處理的方法

C++處理異常的機制引入

在一個小的程序中，能夠用比較簡單的方法處理異常，例如用if語句判別除數是否爲0，若是是。則輸出一個出錯信息。可是在一個大的系統中，包含許多模塊，每一個模塊義包含許多函數，函數之間又五相調用，比較複雜。若是在每個函數中都設置處理異常的程序段，會使程序過於複雜和龐大。所以，C++採起的辦法是：若是在執行一個函數過程當中出現異常，能夠不在本函數中當即處理，而是發出一個信息，傳給它的上一級(即調用它的函數)，它的上級捕捉到這個信啓後進行處理。若是上一級的函數也不能處理，就再傳給其上一級，由其上一級處理。如此逐級上送，若是到最高一級還沒法處理，最後只好異常終止程序的執行。

這樣作使異常的發現與處理不禁同一函數來完成。好處是使底層的函數專門用於解決實際任務，而沒必要再承擔處理異常的任務，以減輕底層函數的負擔，而把處理異常的任務上移到某一層去處理。例如在主函數中調用十幾個函數，只需在主函數中設置處理異常便可，而沒必要在每一個函數中都設置處理異常，這樣能夠提升效率。

C++處理異常的機制組成

C++處理異常的機制是由3個部分組成的，即檢查(try)、拋出(throw)和捕捉(catch)。把須要檢查的語句放在try塊中，throw用來當出現異常時發出(形象地稱爲拋出，throw的意思是拋出)一個異常信息，而catch則用來捕捉異常信息，若是捕捉到廠異常信息，就處理它：

例1 給出三角形的三邊a，b，c，求三角形的面積。只有a+b>c，b+c>a，c+a>b時才能構成三角形。設置異常處理，對不符合三角形條件的輸出警告信息，不予計算。

#include <iostream>

#include <cmath>

using namespace std;

int main()

{

double triangle(double,double,double);

double a,b,c;

cin>>a>>b>>c;

while(a>0 && b>0 && c>0)

{

cout<<triangle(a,b,c)<<endl;

cin>>a>>b>>c;

}

return 0;

}

double triangle (double a, double b, double c)

{

double area;

double s = (a+b+c)/2;

area = sqrt ( s * (s - a) * (s - b) * (s - c));

return area;

}

運行狀況以下：

6 5 4／ (輸入a，b，c的值)

9.92157 (輸出三角形的面積)

1 1.5 2／ (輸入a，b，c的值)

0.726184 (輸出三角形的面積}

1 2 1 ／ (輸人a，b，c的值)

0 (輸出三角形的面積，此結果顯然不對，由於不是三角形)

1 0 6／ (輸入a，b，c的值)(結束)

程序沒有對三角形條件(任意兩邊之和應大於第三邊)進行檢查，所以，當輸入a=l，b=2，c=1時，則計算出三角形的面積爲0，顯然是不合適的。

如今修改程序，在函數triangle中對三角形條件進行檢查，若是不符合三角形條件，就拋出一個異常信息，在主函數中的try-catch塊中調用triangle函數，檢測有無異常信息，並相應處理。修改後的程序以下：

#include <iostream>

#include <cmath>

using namespace std;

int main()

{

double triangle(double,double,double);

double a,b,c;

cin>>a>>b>>c;

try//在try塊中包含要檢查的函數

{

while(a>0 && b>0 && c>0)

{

cout<<triangle(a,b,c)<<endl;

cin>>a>>b>>c;

}

catch(double)//用catch捕捉異常信息並做相應處理

{

cout<<"a="<<a<<",b="<<b<<",c="<<c<<",that is not a traingle!"<<endl;

}

cout<<"end"<<endl;

return 0;

}

double triangle (double a, double b, double c)//計算三角形的面積的函數

{

double sqrt;

double s=(a+b+c)/2;

if (a+b<=c||b+c<=a||c+a<=b) throw a;//當不符合三角形條什拋出異常信息

return sqrt(s*(s-a)*(s-b)*(s-c));

}

程序運行結果以下：

6 5 4 (輸入a，b，c的值)

9.92157 (計算出三角形的面積)

1 1.5 2 (輸入a，b，c的值)

0.726184 (計算出三角形的面積)

1 2 1 (輸入a,b，c的值)

a=1，b=2，c=1，that is not a triangle! (異常處理)

end

如今結合程序分析怎樣進行異常處理。

(1)首先把可能出現異常的、須要檢查的語句或程序段放在try後面的花括號中。因爲riangle函數是可能出現異常的部分，因此把while循環連同triangle函數放在try塊中。這些語句是正常流程的一部分，雖然被放在by塊中，並不影響它們按照原來的順序執行。

(2)程序開始運行後，按正常的順序執行到try塊，開始執行by塊中花括號內的語句。若是在執行try塊內的語句過程當中沒有發生異常，則catch子句不起做用，流程轉到catch子句後面的語句繼續執行。

(3)若是在執行try塊內的語句(包括其所調用的函數)過程當中發生異常，則throw運算符拋出一個異常信息。請看程序中的triangle函數部分，當不知足三角形條件時，throw拋出double類型的異常信息a。throw拋出異常信息後，流程當即離開本函數，轉到其上一級的函數(main函數)。所以不會執行triangle函數中if語句以後的return語句。

throw拋出什麼樣的數據由程序設計者自定，能夠是任何類型的數據(包括自定義類型的據，如類對象)。

(4)這個異常信息提供給try-catch結構，系統會尋找與之匹配的catch子句。如今a是double型，而catch子句的括號內指定的類型也是double型，兩者匹配，即catch捕獲了該異常信息，這時就執行catch子句中的語句，本程序輸出a=1.b=2,c=1,that is not a triangle!

(5)在進行異常處理後，程序並不會自動終止，繼續執行catch子句後面的語句。本程序輸出「end」。注意並非從出現異常點繼續執行while循環。若是在try塊的花括號內有10個語句，在執行第3個語句時出現異常，則在處理完該異常後，其他7個語句再也不執行，而轉到catch子句後面的語句去繼續執行。

因爲catch子句是用來處理異常信息的，每每被稱爲catch異常處理塊或catch異常處理器。

異常處理的語法:

throw語句通常是由throw運算符和一個數據組成的，其形式爲：

throw 表達式;

try-catch的結構爲:

try

{

被檢查的語句;

}

catch(異常信息類型[變量名])

{

進行異常處理的語句;

}

說明：

(1)被檢測的函數必須放在try塊中，不然不起做用。

(2)try塊和catch塊做爲—個總體出現，catch塊是try-catch結構中的一部分，必須緊跟在try塊以後，不能單獨使用，在兩者之間也不能插入其餘語句。

(3)try和catch塊中必須有用花括號括起來的複合語句，即便花括號內只有一個語句，也不能省略花括號。

(4)一個try-catch結構中只能有一個try塊，但卻能夠有多個catch塊，以便與不一樣的異常信息匹配。

(5)catch後面的圓括號中，通常只寫異常信息的類型名，如：catch(double)。

catch只檢查所捕獲異常信息的類型：異常信息能夠是C++系統預約義的標準類型，也能夠是用戶自定義的類型(如結構體或類)。若是由throw拋出的信息屬於該類型或其子類型，則catch與throw兩者匹配，catch捕獲該異常信息。catch還能夠有另一種寫法，即除了指定類型名外，還指定變量名，如：catch(double d)。

此時若是throw拋出的異常信息是double型的變量a，則catch在捕獲異常信息a的同時，還使d得到a的值，或者說d獲得a的一個拷貝。何時須要這樣作呢？有時但願在捕獲異常信息時，還能利用throw拋出的值。

(6)若是在catch子句中沒有指定異常信息的類型，而用了刪節號「…」，則表示它能夠捕捉任何類型的異常信息，如：catch(…) {cout<<"OK"<<endl;}，它能捕捉全部類型的異常信息，並輸出「OK」。

(7)try-catch結構能夠與throw出如今同一個函數中，也能夠不在同一函數中。當throw拋出異常信息後，首先在本函數中尋找與之匹配的catch，若是在本函數中無try-catch結構或找不到與之匹配的catch，就轉到其上一層去處理，若是其上一層也無try-catch結構或找不到與之匹配的catch，則再轉到更上一層的try-catch結構去處理，也就是說轉到離開出現異常最近的try-catch結構去處理。

(8)在某些狀況下，在throw語句中能夠不包括表達式。

(9)若是throw拋出的異常信息找不到與之匹配的catch塊，那麼系統就會調用一個系統函數terminate，使程序終止運行。

例2 在函數嵌套的狀況下檢測異常處理。

這是一個簡單的例子，用來講明在try塊中有函數嵌套調用的狀況下拋出異常和捕捉異常的狀況。

#include <iostream>

using namespace std;

int main ()
{

void f1 ();

try

{

f1 ( ); //調用fl ()

}

catch (double)

{

cout <<"OK0!"<<endl;

}

cout <<"end0"<<endl;

return 0;

}

void f1 ()

{

void f2 ();

try

{

f2 (); //調用f2 ()

}

catch (char)

{

cout <<"OK1!";

}

cout <<"end1"<<endl;

}

void f2 ()

{

void f3 ();

try

{

f3 (); //調用f3 ()

}

catch (int)

{

cout <<"Ok2!"<<endl;

}

cout <<"end2"<<endl;

}

void f3 ()

{

double a = 0;

try

{

throw a; //拋出double類型異常信息

}

catch (float)

{

cout<<"OK3!"<<endl;

}

cout<<"end3"<<endl;

}

分析運行狀況：

(1)若是將f3函數中的catch子句改成catch(double)，而程序中其餘部分不變，則f3函數中的throw拋出的異常信息當即被門函數中的catch子句捕獲(由於拋出的是double型異常，catch要捕捉的也是double型異常，兩者匹配)。因而執行catch子句中的複合語句，輸出"OK3"，再執行catch子句後面的語句，輸出"end3"。f3函數執行結束後，流程返回f2函數中調用f3函數處繼續往下執行。
程序運行結果以下：
OK31 (在f3函數中捕獲異常)
end3 (執行f3函數中最後一個語句時的輸出)
end2 (執行f2函數中最後一個語句時的輸出)
endl (執行u函數中最後一個浯句時的輸出)
endO (執行主函數中最後—個語句時的輸出)
(2)若是在此基礎上再將f3函數中的catch塊改成

catch(double)

{ cout<<"OK3!"<<endl；throw；}
f3函數中的catch子句捕獲throw拋出的異常信息a，輸出"OK3!"表示收到此異常信息，但它當即用"throw;」將a再拋出。因爲a是double型，與f2和門函數中的catch都不匹配，所以最後被main函數中的catch子句捕獲。程序運行結果以下：

OK3!(在f3函數中捕獲異常)

OK0! (在主函數中捕獲異常)

end0 (執行主函數中最後一個語句時的輸出)

3、在函數聲明中進行異常狀況指定
爲了便於閱瀆程序，使用戶在看程序時可以知道所用的函數是否會拋出異常信息以及異常信息可能的類型，C++容許在聲明函數時列出可能拋出的異常類型，如能夠將例1中第二個程序的第3行改寫爲:

double triangle(double，double，double)throw(double)；
表示triangle函數只能拋出double類型的異常信息。若是寫成

double triangle(double，double，double)throw(int，double，float，char)；
則表示triangle函數能夠拋出int，double，float或char類型的異常信息。異常指定是函數聲明的一部分，必須同時出如今函數聲明和函數定義的首行中，不然在進行函數的另外一次聲明時，編澤系統會報告「類型不匹配」。
若是在聲明函數時未列出可能拋出的異常類型，則該函數能夠拋出任何類型的異常信息。如例1中第2個程序中所表示的那樣。
若是想聲明一個不能拋出異常的函數，能夠寫成如下形式：
double triangle(double，double，double) throw()； //throw無參數
這時即便在函數執行過程當中出現了throw語句，實際上也並不執行throw語句，並不拋出任何異常信息，程序將非正常終止。
4、在異常處理中處理析構函數
若是在try塊(或try塊中調用的函數)中定義了類對象，在創建該對象時要調用構造函數。在執行try塊(包括在try塊中調用其餘函數)的過程當中若是發生了異常，此時流程當即離開try塊(若是是在try塊調用的函數中發生異常，則流程首先離開該函數，回到調用它的try塊處，而後流程再從try塊中跳出轉到catch處理塊)。這樣流程就有可能離開該對象的做用域而轉到其餘函數，於是應當事先作好結束對象前的請理工做，C++的異常處理機制會在throw拋出異常信息被catch捕獲時，對有關的局部對象進行析構(調用類對象的析構函數)，析構對象的順序與構造的順序相反，而後執行與異常信息匹配的catch塊中的語句。
例在異常處理中處理析構函數。

這是一個爲說明在異常處理中調用析構函數的示例，爲了請晰地表示流程，程序中加入了一些cout語句，輸出有關的信息，以便讀者對照結果分析程序。

#include <iostream>
#include <string>
using namespace std;
class Student
{ public:
 Student(int n,string nam) //定義構造函數

{ cout<<"construtor-"<<n<<endl;

num=n;name=nam;}

~Student(){cout<<"destructor-"<<num<<endl;} //定義析構函數

void get_data(); //成員函數聲明

private:

int num;
 string name; };
void Student::get_data()
//定義成員函數

{ if(num==0) throw num;
//如num=O，拋出int型變量num

else cout<<num<<" "<<name<<endl; //若num不等O，輸出num，name

cout<<"in get_data()"<<endl; //輸出信息，表示目前在fet_data函數中

}
void fun()
//過程函數（注意可見性)
 { Student stud1(1101,"tan");//創建對象studl

stud1.get_data();

//調用studl的getdata函數

Student stud2(0,"Li");
//創建對象stud2
 stud2.get_data(); }
//調用smd2的get data函數

int main()
{ cout<<"main begin"<<endl; //表示主函數開始了

cout<<"call fun()"<<endl; //表示調用fun函數

try
 {fun();} //調用fun函數

catch(int n)

{ cout<<"num="<<n<<",error!"<<endl;} //表示num=0出錯

cout<<"main end"<<endl; //表示主函數結束

return 0; }

分析程序執行過程,程序運行結果以下：

main begiin
call fun()
constructor-110l
//對立Student類對象stud1,num=1101
110l tan
//對象stud1調用Student類的成員函數get_data,num不等O
in get_data()

//執行get_data
constructor-0

//創建Student類對象stud2,num=0,拋出num.
destructor-O

//調用Student類對象stud1的析構函數
destructor-1101
//調用Student類對象stud2的析構函數
num=O，error!

//表示num=0出錯。
main end

//表示主函數結束

2.21.4 VC編譯器異常選項

#include <stdio.h>

void main ()

{

char *a;

try

{

a = 0;

(*a) = 0;

}

catch(...)

{

printf("oops,exception!!\n");

}

這段代碼的運行結果是什麼？

你必定會說："屏幕上打出oops，exception！！\n"。

沒錯，理論上的確是這樣。

咱們來驗證一下，用vc6產生一個空的win32 console工程，

加入上面的cpp文件，

debug方式編譯後，獲得如期的結果，

可是！

release方式編譯後，仍然出現了"訪問衝突"！

這如何解釋？

本怪獸經調查發現，

VC裏缺身編譯選項裏關於異常的選項是/GX，

文檔裏說，這等價與/EHs--同步異常捕捉。

何解？

答：只有編譯器認爲有可能出異常的狀況下，

即有throw出現的狀況下，

編譯器纔會生成異常捕捉代碼。

聽說是VC6的一項新優化功能，

真是自做聰明！誰會但願這樣的"異常捕捉"？

解決方法，去掉/GX，加上/EHa--異步異常捕捉。

這樣能夠保證異常捕捉代碼不被"高明"的編譯器優化掉。

那爲什麼開頭的例子裏，debug版本運行正常呢？

答：debug版本不作優化。故正常也。

這是VC6 IDE裏很是莫名其妙的地方，

用try catch的人請必定當心。

---------------------------------------------------------------------------------------------------

在【屬性】－》【C/C++】－》【代碼生成】－》【啓用C++異常】有以下4個選項，點擊組合框，顯示：

否

是(/EHsc)

是，但有 SEH 異常(/EHa)

<從父級或項目默認設置繼承>

一、若是不選擇【是，但有 SEH 異常(/EHa)】選項，try { } catch(...) { } 不起做用。新建項目缺省值是【是(/EHsc)】。就是說在缺省狀況下微軟不支持標準C++。

二、微軟本身又弄出：__try { } __except(EXCEPTION_EXECUTE_HANDLER) { }。【啓用C++異常】選項對此不起做用，選什麼都起做用。建議不要使用。仍是使用標準的吧。

三、微軟還弄出：TRY{} CATCH_ALL(e) {} END_CATCH_ALL不知爲何還弄。可能微軟的開發人員那天還得弄。

總結：掌握第1種方法就足夠了，其實也不該該出現其餘方法。若是你的是在從API封裝類，建議仍是用第2種方法，可能你的類要應用到不少項目，那個項目是否選擇了【是，但有 SEH 異常(/EHa)】就很難說了，可能那個程序員根本就沒有注意到【是，但有 SEH 異常(/EHa)】選項，使用第1種方法會使你的異常失效。但我又以爲__try { }實在不是個東西，看着彆扭。

2.21.5 捕獲全部未捕獲的異常

從名字上就能夠看出SetUnhandledExceptionFilter()函數的做用就是設置未捕獲異常的捕獲函數，程序崩潰就是由於有些異常咱們沒有捕獲，而當這些異常咱們沒捕獲時，系統就會調用SetUnhandledExceptionFilter設置的函數，在此函數中能夠進行一些操做，好比彈出對話框、打印語句等。若是沒有設置未捕獲異常的捕獲函數，那麼系統就會調用默認的未捕獲異常的捕獲函數，好比彈出調試對話框、顯示內存讀寫錯誤對話框、等等。

未捕獲異常的捕獲函數的返回值：

EXCEPTION_EXECUTE_HANDLER equ 1 表示我已經處理了異常, 進程能夠結束了

EXCEPTION_CONTINUE_SEARCH equ 0 表示我不處理,其餘人來吧,因而windows調用默認的未捕獲異常的捕獲函數，而後顯示一個錯誤框，並結束

EXCEPTION_CONTINUE_EXECUTION equ -1 表示錯誤已經被修復，請從異常發生處繼續執行

具體使用方法以下：

//未捕獲異常的捕獲函數

LONG WINAPI MyUnhandledExceptionFilter (struct _EXCEPTION_POINTERS * pExp)

{

cout <<"UnhandledException!!!"<<endl;

return EXCEPTION_EXECUTE_HANDLER;//返回異常已經處理，並能夠結束進程的標記

}

int main ()

{

cout <<"begin!"<<endl;

SetUnhandledExceptionFilter (MyUnhandledExceptionFilter);

int i = 0;

i = i / i;

cout <<"end!"<<endl;

getch ();

return 0;

}

2.21.6 SetErrorMode(未完成)

函數名稱	SetErrorMode
頭文件	#include <Windows.h>
庫文件	#pragma comment(lib, "Kernel32.lib")
函數功能	設置錯誤處理方式，選擇是否讓操做系統處理指定類型的嚴重錯誤，仍是讓調用進程來處理它們。
函數聲明	UINT WINAPI SetErrorMode ( UINT uMode );
函數參數	uMode，[輸入]：存放要讓操做系統處理哪些類型的嚴重錯誤，能夠爲（用'\|'選零至多個）： 0：使用系統默認的，既讓操做系統處理全部錯誤。 SEM_FAILCRITICALERRORS（0x0001）：若是設置本標記，表示不讓系統處理關鍵錯誤，讓調用進程來處理。若是不設置本標記，表示要讓系統處理關鍵錯誤，不讓調用進程來處理。系統會自動彈出一個對話框來讓用戶選擇如何處理。 SEM_NOALIGNMENTFAULTEXCEPT（0x0004）：若是設置本標記，表示The system automatically fixes memory alignment faults and makes them invisible to the application. It does this for the calling process and any descendant processes. This feature is only supported by certain processor architectures. For more information, see the Remarks section.After this value is set for a process, subsequent attempts to clear the value are ignored. 不建議設置本標記。 SEM_NOGPFAULTERRORBOX（0x0002）：若是設置本標記，表示不讓系統顯示Windows錯誤報告對話框。若是不設置本標記，表示要讓系統顯示Windows錯誤報告對話框。系統會自動彈出一個錯誤報告對話框來讓用戶選擇如何處理，對話框截圖： SEM_NOOPENFILEERRORBOX（0x8000）若是設置本標記，表示不讓系統處理沒法找到文件時的錯誤，讓調用進程來處理。若是不設置本標記，表示要讓系統處理沒法找到文件時的錯誤。系統會自動彈出一個對話框來讓用戶選擇如何處理。例如試圖從一個沒有軟盤的軟驅中讀數據。
返回值	返回值1：返回值說明。返回值2：返回值說明。 ……
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是或否或未知，表示此函數多線程調用是否會產生影響
原子操做	是或否或未知，表示此函數是不是單一操做，不是多個步驟的組合
其餘說明	…… ……

2.22 錯誤碼

2.22.1 GetLastError

函數名稱	GetLastError
頭文件	#include <windows.h>
函數功能	獲取本線程最近一次調用系統函數的錯誤碼，多線程互不影響。由於使用的線程局部變量來存放錯誤碼。
函數聲明	DWORD GetLastError ( void );
函數參數	無
返回值	本線程最近一次的錯誤碼。
錯誤碼	無
線程安全	是
原子操做	是
其餘說明	能夠使用FormatMessage()函數獲取錯誤碼對應的信息字符串。

2.22.2 FormatMessage(未完成)

函數名稱	FormatMessage
頭文件	#include <Windows.h>
函數功能	根據GetLastError()函數返回的錯誤碼，獲取此錯誤碼對應的錯誤信息字符串存放在指定內存。
函數聲明	DWORD FormatMessage ( DWORD dwFlags, LPCVOID lpSource, DWORD dwMessageId, DWORD dwLanguageId, LPSTR lpBuffer, DWORD nSize, va_list * Arguments );
函數參數	dwFlags，[輸入]：能夠是（用'\|'選一至多個）： FORMAT_MESSAGE_FROM_SYSTEM：在系統id映射表中查找錯誤信息字符串。 FORMAT_MESSAGE_FROM_HMODULE：在其餘資源模塊中查找錯誤信息字符串。此標記不能和FORMAT_MESSAGE_FROM_STRING標記同時使用。 FORMAT_MESSAGE_FROM_STRING：lpSource參數是一個指向以NULL結尾的字符串，字符串包含一個消息定義，這個消息定義能夠包含插入序列。此標誌最好不要和FORMAT_MESSAGE_FROM_HMODULE或者FORMAT_MESSAGE_FROM_SYSTEM使用。此標記不能和FORMAT_MESSAGE_FROM_HMODULE標記同時使用。 FORMAT_MESSAGE_ALLOCATE_BUFFER：要此函數會自動分配內存來存放錯誤信息字符串，而不是本身指定。 FORMAT_MESSAGE_IGNORE_INSERTS：在消息定義中的插入序列將會被忽略，也就是忽略Arguments參數。 FORMAT_MESSAGE_ARGUMENT_ARRAY：Arguments參數不是一個va_list結構，它表示一個數組指針。這個標識符不能在64位整數值時使用，你若是要使用64位整數值，那麼你必須使用va_list結構體。
	lpSource，[輸入]：若是dwFlags參數指定了FORMAT_MESSAGE_FROM_HMODULE標記，本參數表示模塊句柄。若是dwFlags參數指定了FORMAT_MESSAGE_FROM_STRING標記，本參數表示id字符串。其餘狀況本參數無心義，必須爲NULL。
	dwMessageId，[輸入]：存放GetLastError()函數返回的錯誤碼。若是dwFlags參數指定FORMAT_MESSAGE_FROM_STRING標記，則本參數無心義，必須爲NULL。
	dwLanguageId，[輸入]：錯誤信息字符串所用的語言，爲0表示系統自動選擇。
	lpBuffer，[輸入]：存放錯誤信息字符串的內存指針，可是若是dwFlags指定了FORMAT_MESSAGE_ALLOCATE_BUFFER，系統會調用LocalAlloc()函數自動分配內存，本參數就爲存放該內存指針的指針變量的內存指針，用戶須要記住調用LocalFree()函數釋放該內存。
	nSize，[輸入]：存放錯誤信息字符串的內存長度，可是若是dwFlags指定了FORMAT_MESSAGE_ALLOCATE_BUFFER，本參數就爲系統自動分配的內存的最小長度。
	Arguments，[輸入]：未知，必須爲NULL。
返回值	非0：存放在內存的錯誤信息字符串的長度。 0：失敗，調用GetLastError()函數查看錯誤碼。
錯誤碼	EXXXX：錯誤碼說明。 EXXXX：錯誤碼說明。 ……
線程安全	是
原子操做	是
其餘說明	lpSource參數若是是模塊句柄，能夠調用LoadLibraryEx ("DLL文件名", NULL, LOAD_LIBRARY_AS_DATAFILE)函數獲取。 lmerr.h、netmsg.dll模塊包含NERR_BASE(2100)至MAX_NERR(2999)的錯誤碼對應的信息字符串。 wininet.h、wininet.dll模塊包含INTERNET_ERROR_BASE(12000)至INTERNET_ERROR_LAST(12175)的錯誤碼對應的信息字符串。 pdhmsg.h、pdh.dll模塊包含PDH_CSTATUS_VALID_DATA(0)至PDH_CSTATUS_NEW_DATA(1)、PDH_CSTATUS_NO_MACHINE(2147485648)至PDH_QUERY_PERF_DATA_TIMEOUT(3221228542)的錯誤碼對應的信息字符串。系統id映射表包含WSA錯誤碼10000至1199九、IPSec錯誤碼13000至1399九、Side By Side錯誤碼14000至1499九、WinEvt錯誤碼15000至1507九、Wecsvc錯誤碼15080至1509九、MUI錯誤碼15100至1519九、Monitor Configuration API錯誤碼15200至1524九、Syspart錯誤碼15250至1529九、Vortex錯誤碼15300至15320、及其餘的錯誤碼對應的信息字符串。

3 類庫

3.1 類模板

3.2 list

3.2.1 list類簡介

list類是一種可在常數時間內在任何位置執行插入元素和刪除元素操做的順序容器。list類是雙向鏈表，其迭代器是雙向的。list類變量能夠在任意位置高效執行插入、提取、和移動元素的操做，但它不能經過在list類變量中的位置直接操做元素。

頭文件：#include <list>

assign（）給list賦值

front（）返回第一個元素

back（）返回最後一個元素

begin（）返回指向第一個元素的迭代器

end（）返回最後一個元素的下一個元素的迭代器，其實就是NULL，用於表示鏈表結束。

clear（）刪除全部元素

empty（）判斷本類變量有沒有元素，若是有，則返回true，若是沒有，則返回false。

erase（）刪除一個元素

get_allocator（）返回list的配置器

insert（）插入一個元素

max_size（）返回list能容納的最大元素數量

merge（）合併兩個list

pop_back（）刪除最後一個元素

pop_front（）刪除第一個元素

push_back（）在list的末尾添加一個元素

push_front（）在list的頭部添加一個元素

rbegin（）返回指向第一個元素的逆向迭代器

remove（）從list刪除元素

remove_if（）按指定條件刪除元素

rend（）指向list末尾的逆向迭代器

resize（）改變list的大小

reverse（）把list的元素倒轉

size（）返回list中的元素個數

sort（）給list排序

splice（）合併兩個list

swap（）交換兩個list

unique（）刪除list中重複的元素

3.3 map

關聯容器與順序容器

關聯容器經過鍵（key）存儲和讀取元素，而順序容器則經過元素在容器中的位置順序存儲和訪問元素。

關聯容器（Associative containers）支持經過鍵來高效地查找和讀取元素。兩個基本的關聯容器類型是 map 和 set。其中map 的元素以鍵－值（key-value）對的形式組織：鍵用做元素在 map 中的索引，而值則表示所存儲和讀取的數據。set 僅包含一個鍵，並有效地支持關於某個鍵是否存在的查詢。

關聯容器類型

通常來講，若是但願有效地存儲不一樣值的集合，那麼使用 set 容器比較合適，而 map 容器則更適用於須要存儲（乃至修改）每一個鍵所關聯的值的狀況。在作某種文本處理時，可以使用 set 保存要忽略的單詞。而字典則是 map 的一種很好的應用：單詞自己是鍵，而它的解釋說明則是值。 set 和 map 類型的對象所包含的元素都具備不一樣的鍵，不容許爲同一個鍵添加第二個元素。若是一個鍵必須對應多個實例，則需使用 multimap 或 multi set，這兩種類型容許多個元素擁有相同的鍵。

C++ Primer Plus 第6版中文版清晰有書籤PDF+源代碼 http://www.linuxidc.com/Linux/2014-05/101227.htm

讀C++ Primer 之構造函數陷阱 http://www.linuxidc.com/Linux/2011-08/40176.htm

讀C++ Primer 之智能指針 http://www.linuxidc.com/Linux/2011-08/40177.htm

讀C++ Primer 之句柄類 http://www.linuxidc.com/Linux/2011-08/40175.htm

將C語言梳理一下，分佈在如下10個章節中：

Linux-C成長之路（一）：Linux下C編程概要 http://www.linuxidc.com/Linux/2014-05/101242.htm
Linux-C成長之路（二）：基本數據類型 http://www.linuxidc.com/Linux/2014-05/101242p2.htm
Linux-C成長之路（三）：基本IO函數操做 http://www.linuxidc.com/Linux/2014-05/101242p3.htm
Linux-C成長之路（四）：運算符 http://www.linuxidc.com/Linux/2014-05/101242p4.htm
Linux-C成長之路（五）：控制流 http://www.linuxidc.com/Linux/2014-05/101242p5.htm
Linux-C成長之路（六）：函數要義 http://www.linuxidc.com/Linux/2014-05/101242p6.htm
Linux-C成長之路（七）：數組與指針 http://www.linuxidc.com/Linux/2014-05/101242p7.htm
Linux-C成長之路（八）：存儲類，動態內存 http://www.linuxidc.com/Linux/2014-05/101242p8.htm
Linux-C成長之路（九）：複合數據類型 http://www.linuxidc.com/Linux/2014-05/101242p9.htm
Linux-C成長之路（十）：其餘高級議題

注意：關聯容器根據鍵排列元素！因此，在迭代遍歷訪問容器時，是按照鍵的順序訪問元素，而與元素在容器中的存放位置無關！

3.3.1 基礎pair類型

在utility頭文件定義。

3.3.2 map類型

3.3.2.1 map類型的定義

map 是鍵－值對的集合。map 類型一般可理解爲關聯數組（associative array）：可以使用鍵做爲下標來獲取一個值，正如內置數組類型同樣。而關聯的本質在於元素的值與某個特定的鍵相關聯，而並不是經過元素在數組中的位置來獲取。

map對象的構造函數即定義方法：

在實際應用中，鍵類型必須定義 < 操做符，好比list<> 容器的類型則不能做爲鍵。
在使用關聯容器時，它的鍵不但有一個類型，並且還有一個相關的比較函數。所用的比較函數必須在鍵類型上定義嚴格弱排序（strict weak ordering）。所謂的嚴格弱排序可理解爲鍵類型數據上的「小於」關係。當用於一個鍵與自身的比較時，確定會致使 false 結果。若是它們相互之間都不存在「小於」關係，則容器將之視爲相同的鍵。用作 map 對象的鍵時，可以使用任意一個鍵值來訪問相應的元素。這與下面的添加元素時行爲有必定的對應

3.3.2.2 map定義的類型

其中：其 value_type 是存儲元素的鍵以及值的 pair 類型，並且鍵爲 const。

// count number of times each word occurs in the input
map<string, int> word_count; // empty map from string to int
// get an iterator to an element in word_count
map<string, int>::iterator map_it = word_count.begin(); // *map_it is a reference to a pair<const string, int> objectcout << map_it->first; // prints the key for this element
cout << " " << map_it->second; // prints the value of the element

map_it->first = "new key"; // error: key is const

++map_it->second; // ok: we can change value through an iterator

對迭代器進行解引用將得到一個pair對象，其first成員具備const map<K, V>::key_type 類型即存放鍵，而 second成員則爲map<K,V>::mapped_type 類型，即存放值。

3.3.2.3 map元素添加

3.3.2.3.1 1、下標添加

當編寫如下代碼時：

map <string, int> word_count; // empty map
// insert default initialzed element with key Anna; then assign 1 to its value
word_count["Anna"] = 1;

將發生：

1.在 word_count 中查找鍵爲 Anna 的元素，沒有找到。
2.將一個新的鍵－值對插入到 word_count 中。它的鍵是 const string 類型的對象，保存 Anna。而它的值則採用值初始化，這就意味着在本例中值爲 0。
3.將這個新的鍵－值對插入到 word_count 中。
4.讀取新插入的元素，並將它的值賦爲 1。
使用下標訪問 map 與使用下標訪問數組或 vector 的行爲大相徑庭：用下標訪問不存在的元素將致使在 map 容器中添加一個新元素，它的鍵即爲該下標值。

PS：下標操做符返回值的使用
一般來講，下標操做符返回左值。它返回的左值是特定鍵所關聯的值。可以下讀或寫元素：

// count number of times each word occurs in the input
map<string, int> word_count; // empty map from string to int
string word;
while (cin >> word)
++word_count[word];

3.3.2.3.2 2、insert添加

map上的insert操做

1.添加元素

// if Anna not already in word_count,inserts new element with value 1
word_count.insert(map<string, int>::value_type("Anna", 1));

上面語句的實參能夠簡化以下兩種方法：

（1） word_count.insert(make_pair("Anna", 1));

（2）使用 typedef

typedef map<string,int>::value_type valType;
word_count.insert(valType("Anna", 1));

二、insert的返回值

There can be only one element with a given key in a map. If we attempt to insert an element with a key that is already in the map, then insert does nothing. The versions of insert that take an iterator or iterator pair do not indicate whether or how many elements were inserted.

可是，帶有一個鍵－值 pair 形參的 insert 版本將返回一個值：包含一個迭代器和一個 bool 值的 pair 對象，其中迭代器指向 map 中具備相應鍵的元素，而 bool 值則表示是否插入了該元素。若是該鍵已在容器中，則其關聯的值保持不變，返回的 bool 值爲 false。在這兩種狀況下，迭代器都將指向具備給定鍵的元素。

3.3.2.4 查找以及讀取map中的元素

3.3.2.4.1 1、下標讀取

map<string,int> word_count;
int occurs = word_count["foobar"];

可是：使用下標存在一個很危險的反作用：若是該鍵不在 map 容器中，那麼下標操做會插入一個具備該鍵的新元素。

3.3.2.5 2、不修改map對象的查詢操做

（1） m.count(k)；返回 m 中 k 的出現次數

（2） m.find(k)；若是 m 容器中存在按 k 索引的元素，則返回指向該元素的迭代器。若是不存在，則返回超出末端迭代器

-----使用count檢查對象總某鍵是否存在

對於 map 對象，count 成員的返回值只能是 0 或 1。map 容器只容許一個鍵對應一個實例，因此 count 可有效地代表一個鍵是否存在。若是返回值非 0，則能夠使用下標操做符來獲取該鍵所關聯的值，而沒必要擔憂這樣作會在 map 中插入新元素：
int occurs = 0;
if (word_count.count("foobar"))
occurs = word_count["foobar"];

固然，在執行 count 後再使用下標操做符，其實是對元素做了兩次查找。若是但願當元素存在時就使用它，則應該用 find 操做。

-----讀取元素而不插入該元素

find 操做返回指向元素的迭代器，若是元素不存在，則返回 end 迭代器：

若是但願當具備指定鍵的元素存在時，就獲取該元素的引用，不然就不在容器中建立新元素，那麼應該使用 find。

3.3.3 刪除map元素

3.3.4 遍歷map對象

map一樣提供begin和end運算。以生成遍歷整個元素的迭代器

ok，that`s all .

3.3.5 實際程序演練

1、單詞統計

代碼一：

// 創建一個map對象，保存所讀入的單詞及其出現的次數(以單詞爲鍵，對應的值爲單詞出現的次數)
// 利用下標添加元素

#include <iostream>
#include <map>
#include <string>
using namespace std;
// 2013.11.18 Written by C_SuooL_Hu
int main()
{
// freopen("in.txt","r",stdin);
// freopen("out.txt","w",stdout);
map<string, int> wordCount;
typedef map<string, int> ::iterator valType;
string word;
// 讀入單詞並統計次數
cout << "Enter some words (Ctrl + Z to end):" << endl;
while (cin >> word)
{
// 若是讀入的word存在在容器中，則使鍵值爲word的值++，不然添加以此元素爲索引的鍵，而後鍵值初始化爲0，後++，即爲1.
++wordCount[word];
}
// 輸出結果，用迭代器
cout << "word\t\t" << "times" << endl;
for (valType iter = wordCount.begin(); iter != wordCount.end(); ++iter)
{
cout << (*iter).first << "\t\t" << (*iter).second << endl;
}
return 0;
}

代碼二：

#include <iostream>
#include <map>
#include <string>
using namespace std;
<pre style="line-height: 24.5px;" class="cpp" name="code">// 2013.11.18 Written by C_SuooL_Hu</pre>// mapint main() { freopen("in.txt","r",stdin); freopen("out.txt","w",stdout); // count number of times each word occurs in the input map<string, int> word_count;
// empty map from string to int typedef map<string, int> ::iterator valType; string word; while (cin >> word) { // inserts element with key equal to word and value 1; // if word already in word_count, insert does nothing pair<map<string, int>::iterator, bool>
ret =word_count.insert(make_pair(word, 1)); if (!ret.second) // word already in word_count ++ret.first->second; // increment counter }// outputcout << "word\t\t" << "times" << endl;for (valType iter = word_count.begin(); iter != word_count.end(); ++iter){cout
<< (*iter).first << "\t\t" << (*iter).second << endl;}return 0;}

運行結果：

有圖可知，用迭代器輸出的時候，按照字典序輸出。

3.3.6 2、單詞轉換器（轉換譯碼）

代碼有點醜，輸入輸出IO庫還很須要增強。。。對文件的操做基本是文盲。。

#include <map>
#include <vector>
#include <iostream>
#include <fstream>
#include <string>
#include <sstream>
// 2013.11.18 Written by C_SuooL_Hu
using namespace std;

ifstream& open_file(ifstream&, const string&);

int main()

{
freopen("out.txt", "w", stdout);
// map to hold the word transformation pairs:
// key is the word to look for in the input; value is word to use in the output
map<string, string> trans_map;
string key, value;

// ´´½¨Á÷
ifstream myfile ("trans_map.txt");
ifstream myfilein ("in.txt");
ofstream outfile("out.txt");
// ÅÐ¶ÏÎÄ¼þÊÇ·ñ´ò¿ª
if(!myfile)
{
cout << "Unable to open myfile";
exit(1); // terminate with error

}
if(!outfile)
{
cout << "Unable to open outfile";
exit(1); // terminate with error

}

// read the transformation map and build the map
while (myfile >> key >> value)
{
trans_map.insert(make_pair(key, value));
}

// this block just produces the vector so that we can print it
// for the book
cout << "Here is our transform string input:\n\n";
// read some text to transform
string word;

// ok, now we're ready to do the transformations
// open the input file and check that the open succeeded
string WORD;
bool firstword = true; // controls whether a space is printed
while (myfilein >> WORD)
{
// ok: the actual mapwork, this part is the heart of the program
map<string, string>::const_iterator map_it =
trans_map.find(WORD);

// if this word is in the transformation map
if (map_it != trans_map.end())
{
// replace it by the transformation value in the map
WORD = map_it->second;
}
if (firstword)
firstword = false;
else
cout << " "; // print space between words
cout << WORD;
}
cout << endl; // done with this line of input
return 0;
}
測試結果：

4 結構體庫

4.1 結構體模板(未完成)

結構體名稱	xxx
頭文件	#include <xxx.h> #include <xxx.h>
結構體稱呼	結構體的中文稱呼。
結構體說明	結構體主要用途說明。
相關函數	Func1()、Func2()、Func3()…
結構體聲明	struct xxx { 類型成員變量1; 類型成員變量2; …… };
成員變量	成員變量1：成員變量說明。
	成員變量2：成員變量說明。
	……
其餘說明	…… ……

4.2 套接字

4.2.1 sockaddr

頭文件：#include <linux/socket.h>

結構體名稱：sockaddr

結構體說明：結構體主要使用說明。

結構體聲明：struct sockaddr

{

sa_family_t sa_family; /* address family, AF_xxx */

char sa_data[14]; /* 14 bytes of protocol address */

};

成員變量：sa_family：IP地址的地址族，用AF_xxx定義的

sa_data：協議的地址數據，佔14個字節的

注意事項：

……

4.2.2 sockaddr_in

頭文件：#include <netinet/in.h>

結構體名稱：sockaddr_in

結構體說明：通常用於對IPv4的地址信息的說明。

結構體聲明：struct sockaddr_in

{

__SOCKADDR_COMMON (sin_);

in_port_t sin_port; /* Port number. */

struct in_addr sin_addr; /* Internet address. */

/* Pad to size of `struct sockaddr'. */

unsigned char sin_zero[sizeof (struct sockaddr) -

__SOCKADDR_COMMON_SIZE -

sizeof (in_port_t) -

sizeof (struct in_addr)];

};

成員變量：sin_port：存放端口號。

sin_addr：存放IP地址。

sin_zero：填充數據，爲了佔滿14個字節，無實際意義。

注意事項：

……

4.2.3 sockaddr_in6

頭文件：#include <netinet/in.h>

結構體名稱：sockaddr_in6

結構體說明：通常用於對IPv6的地址信息的說明。

結構體聲明：struct sockaddr_in6

{

__SOCKADDR_COMMON (sin6_);

in_port_t sin6_port; /* Transport layer port # */

uint32_t sin6_flowinfo; /* IPv6 flow information */

struct in6_addr sin6_addr; /* IPv6 address */

uint32_t sin6_scope_id; /* IPv6 scope-id */

};

成員變量：sin6_port：成員變量說明。

sin6_flowinfo：成員變量說明。

sin6_addr：

sin6_scope_id：

注意事項：

……

4.3 軟硬件設備

4.3.1 通用

4.3.1.1 SYSTEM_PROCESS_INFORMATION(未完成)

結構體名稱	SYSTEM_PROCESS_INFORMATION
頭文件	#include <Winternl.h>
結構體說明	存放系統中各個進程的相關信息。
相關函數	NtQuerySystemInformation()、Func2()、Func3()…
結構體聲明	struct SYSTEM_PROCESS_INFORMATION { ULONG NextEntryOffset; BYTE Reserved1[52]; PVOID Reserved2[3]; HANDLE UniqueProcessId; PVOID Reserved3; ULONG HandleCount; BYTE Reserved4[4]; PVOID Reserved5[11]; SIZE_T PeakPagefileUsage; SIZE_T PrivatePageCount; LARGE_INTEGER Reserved6[6]; }
成員變量	NextEntryOffset：存放下一個進程信息結構體的起始位置指針相對本結構體的起始位置指針的偏移長度，單位字節。若是本參數爲0，表示本結構體就爲最後一個，沒有下一個了。
	Reserved1：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	Reserved2：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	UniqueProcessId：存放進程的全局惟一ID。
	Reserved3：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	HandleCount：存放進程的句柄數。
	Reserved4：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	Reserved5：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	PeakPagefileUsage：存放進程的虛擬內存使用大小峯值，單位字節，有待考證。
	PrivatePageCount：存放進程的提交大小，單位字節，也就是進程動態申請的內存的理論長度。
	Reserved6：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
其餘說明

4.3.1.2 _SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION

結構體名稱	_SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION
頭文件	#include <Winternl.h>
結構體說明	存放每一個CPU處理器核心的相關信息。
相關函數	NtQuerySystemInformation()、Func2()、Func3()…
結構體聲明	typedef struct _SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION { LARGE_INTEGER IdleTime; LARGE_INTEGER KernelTime; LARGE_INTEGER UserTime; LARGE_INTEGER Reserved1[2]; ULONG Reserved2; } SYSTEM_PROCESSOR_PERFORMANCE_INFORMATION;
成員變量	IdleTime：存放CPU處理器核心的空閒時間。
	KernelTime：存放CPU處理器核心的內核時間。
	UserTime：存放CPU處理器核心的用戶時間。
	Reserved1：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
	Reserved2：保留參數，其實並非沒有用到，只是微軟隱藏了而已。
其餘說明

4.3.2 CPU處理器

4.3.3 內存

4.3.3.1 MEMORYSTATUS(未完成)

結構體名稱	MEMORYSTATUS
頭文件	#include <WinBase.h>
結構體說明	存放物理內存和虛擬內存的相關信息。
相關函數	GlobalMemoryStatus()
結構體聲明	struct MEMORYSTATUS { DWORD dwLength; DWORD dwMemoryLoad; SIZE_T dwTotalPhys; SIZE_T dwAvailPhys; SIZE_T dwTotalPageFile; SIZE_T dwAvailPageFile; SIZE_T dwTotalVirtual; SIZE_T dwAvailVirtual; };
成員變量	dwLength：存放本結構體佔用字節大小。本參數由GlobalMemoryStatus()函數自動設置，無需事先設置。
	dwMemoryLoad：存放物理內存的使用率，單位百分比，數值大於等於0，小於等於100。 0表示沒有使用任何內存，100表示使用了所有內存。
	dwTotalPhys：存放物理內存總大小，單位字節。若是物理內存總大小超過4GB，本參數將一直爲4GB。
	dwAvailPhys：存放物理內存剩餘可用大小，單位字節。若是物理內存剩餘可用大小超過4GB，本參數將一直爲4GB。
	dwTotalPageFile：存放虛擬內存的頁面文件總大小，單位字節。本參數並不表示頁面文件在磁盤上的實際文件大小。若是物理內存剩餘可用大小超過4GB，本參數將一直爲4GB。
	dwAvailPageFile：存放當前調用進程對頁面文件的最大可用大小，單位字節。本參數應該小於頁面文件剩餘可用大小。若是當前調用進程對頁面文件的最大可用大小超過4GB，本參數將一直爲4GB。
	dwTotalVirtual：存放當前調用進程的虛擬地址空間的用戶空間的總大小，以字節爲單位。本參數與CPU硬件性能參數及操做系統有關，例如，該值約爲2 GB的在x86處理器上大多數32位進程和大約3 GB的32位進程是大地址識別運行的系統上4 GT RAM微調功能。若是當前調用進程的虛擬地址空間的用戶空間的總大小超過4GB，本參數將一直爲4GB。
	dwAvailVirtual：存放當前調用進程的虛擬地址空間的用戶空間的剩餘可用大小，以字節爲單位。若是當前調用進程的虛擬地址空間的用戶空間的剩餘可用大小超過4GB，本參數將一直爲4GB。
其餘說明	本結構體只能獲取內存大小不超過4GB的相關信息，若是要獲取內存大小超過4GB的相關信息，能夠調用GlobalMemoryStatusEx()函數。

4.4 網絡設備

4.4.1 MIB_IFROW

結構體名稱

MIB_IFROW

頭文件

#include <Iphlpapi.h>

結構體說明

存放網絡設備的狀態信息，包括名稱、索引序號、類型、最大傳輸單元、傳輸速度、物理地址、管理狀態、操做狀態、輸入輸出流量記錄、描述。

相關函數

GetIfTAble()

結構體聲明

struct MIB_IFROW

{

WCHAR wszName[MAX_INTERFACE_NAME_LEN];

IF_INDEX dwIndex;

IFTYPE dwType;

DWORD dwMtu;

DWORD dwSpeed;

DWORD dwPhysAddrLen;

UCHAR bPhysAddr[MAXLEN_PHYSADDR];

DWORD dwAdminStatus;

INTERNAL_IF_OPER_STATUS dwOperStatus;

DWORD dwLastChange;

DWORD dwInOctets;

DWORD dwInUcastPkts;

DWORD dwInNUcastPkts;

DWORD dwInDiscards;

DWORD dwInErrors;

DWORD dwInUnknownProtos;

DWORD dwOutOctets;

DWORD dwOutUcastPkts;

DWORD dwOutNUcastPkts;

DWORD dwOutDiscards;

DWORD dwOutErrors;

DWORD dwOutQLen;

DWORD dwDescrLen;

UCHAR bDescr[MAXLEN_IFDESCR];

};

成員變量

wszName：

存放網絡設備的惟一GUID名稱字符串。

dwIndex：

存放網絡設備的惟一索引序號，能夠使用route print命令的接口列表查看。

dwType：

存放網絡設備的類型，能夠爲：

IF_TYPE_OTHER（1）：

其餘的網絡設備。

IF_TYPE_ETHERNET_CSMACD（6）：

以太網網絡設備。

IF_TYPE_ISO88025_TOKENRING（9）：

令牌環網網絡設備。

IF_TYPE_FDDI（15）：

FDDI光纖分佈式數據接口（Fiber Distributed-Data Interface）網絡設備。

IF_TYPE_PPP（23）：

PPP點對點協議（Point to Point Protocol）網絡設備。

IF_TYPE_SOFTWARE_LOOPBACK（24）：

軟件迴環網絡接口。

IF_TYPE_SLIP（28）：

串行適配器（Serial Line Interface Protocol）。

IF_TYPE_ATM（37）：

異步傳輸模式（Asynchronous Transfer Mode）網絡設備。

IF_TYPE_IEEE80211（71）：

基於IEEE 802.11標準的無線網絡設備。

IF_TYPE_TUNNEL（131）：

隧道式封裝（Tunnel-encapsulated）網絡設備。

IF_TYPE_IEEE1394（144）：

基於IEEE 1394（火線）高性能串行總線的網絡設備。

IF_TYPE_IEEE80216_WMAN（237）：

基於WiMax全球微波互聯接入 (Worldwide Interoperability for Microwave Access)的移動網絡設備。

注意：只有Windows 7和Windows Server 2008 R2及之後的系統支持此類型設備。

IF_TYPE_WWANPP（243）：

基於GSM全球移動通訊系統（Global System for Mobile communication）標準的移動網絡設備。

注意：只有Windows 7和Windows Server 2008 R2及之後的系統支持此類型設備。

IF_TYPE_WWANPP2（244）：

基於CDMA碼分多址技術的移動網絡設備。

注意：只有Windows 7和Windows Server 2008 R2及之後的系統支持此類型設備。

dwMtu：

存放網絡設備的最大傳輸單元的長度，單位字節。

dwSpeed：

存放網絡設備的最大傳輸速率，單位比特位每秒。

有些設備是以1000爲進制單位的，有些是以1024爲進制單位的，表示不同，但實際意思都是同樣的，例如：1000Mbps的速率，本參數可能爲1000*1000*1000=1000000000 bps，也可能爲1024*1024*1024=1073741824 bps。

dwPhysAddrLen：

存放bPhysAddr參數的使用長度，單位字節。

bPhysAddr：

存放網絡設備的MAC物理地址。

dwAdminStatus：

存放網絡設備的管理狀態，1表示啓用，2表示禁用。

管理狀態是指經過控制面板的網絡和共享中心等方式對該網絡設備進行管理。

dwOperStatus：

存放網絡設備的操做狀態。能夠爲：

IF_OPER_STATUS_NON_OPERATIONAL（0）：

LAN局域網適配器已被禁用，例如：地址衝突。

IF_OPER_STATUS_UNREACHABLE（1）：

WAN廣域網適配器未鏈接。

IF_OPER_STATUS_DISCONNECTED（2）：

對於LAN局域網適配器，表示網絡電纜斷開。對於WAN廣域網適配器，表示無信號。

IF_OPER_STATUS_CONNECTING（3）：

WAN廣域網適配器正在進行鏈接。

IF_OPER_STATUS_CONNECTED（4）：

WAN廣域網適配器已經鏈接到遠端對等網絡。

IF_OPER_STATUS_OPERATIONAL（5）：

LAN局域網適配器的默認狀態，例如：已經鏈接。

dwLastChange：

存放網絡設備的已進入當前操做狀態了多久，單位百分之一秒。

操做狀態就是dwOperStatus成員變量所指示的操做狀態。

當系統從新啓動，或本參數達到2^32後，本參數清0。

dwInOctets：

存放網絡設備的累計輸入流量，單位字節。

dwInUcastPkts：

存放網絡設備的輸入包的累計個數。

dwInNUcastPkts：

存放網絡設備的輸入包的累計非單播個數。

非單播是指廣播和多播。

dwInDiscards：

存放網絡設備的輸入包的累計丟棄個數。

丟棄緣由多是錯誤的，或者重複的，或者協議未知，等等。

dwInErrors：

存放網絡設備的輸入包的累計因錯誤丟棄個數。

dwInUnknownProtos：

存放網絡設備的輸入包的累計因協議未知丟棄個數。

dwOutOctets：

存放網絡設備的累計輸出流量，單位字節。

dwOutUcastPkts：

存放網絡設備的輸出包的累計個數。

dwOutNUcastPkts：

存放網絡設備的輸入包的累計非單播個數。

非單播是指廣播和多播。

dwOutDiscards：

存放網絡設備的輸出包的累計丟棄個數。

丟棄緣由多是錯誤的，或者重複的，或者協議未知，等等。

dwOutErrors：

存放網絡設備的輸出包的累計因錯誤丟棄個數。

dwOutQLen：

存放網絡設備的輸出緩存長度。

本參數已再也不使用。

dwDescrLen：

存放網絡設備的bDescr參數描述字符串的長度，包括'\0'結束符。

bDescr：

存放網絡設備的描述字符串，一般爲硬件型號、軟件虛擬名稱。

其餘說明

4.4.2 IP_ADAPTER_INFO

結構體名稱	IP_ADAPTER_INFO
頭文件	#include <IPTypes.h>
結構體說明	存放網絡適配器的狀態信息。
相關函數	GetAdaptersInfo()
結構體聲明	struct xxx { 類型成員變量1; 類型成員變量2; …… };
成員變量	成員變量1：成員變量說明。
	成員變量2：成員變量說明。
	……
其餘說明	…… ……

4.4.3 IP_INTERFACE_INFO(未完成)

結構體名稱	IP_INTERFACE_INFO
頭文件	#include <IPExport.h>
結構體說明	存放本機全部啓用了IPv4協議的物理和虛擬的網絡適配器的名稱和索引序號。
相關函數	GetInterfaceInfo()
結構體聲明	struct IP_INTERFACE_INFO { LONG NumAdapters; IP_ADAPTER_INDEX_MAP Adapter[1]; };
成員變量	NumAdapters：存放本結構體存放了多少個網絡適配器。
成員變量	IP_ADAPTER_INDEX_MAP：存放網絡適配器的名稱和索引序號的動態數組，若是NumAdapters參數爲0，本參數無心義。
其餘說明	本結構體只存放本機全部啓用了IPv4協議的物理和虛擬的網絡適配器，

4.5 性能計數器

4.5.1 PPDH_FMT_COUNTERVALUE(未完成)

結構體名稱	PPDH_FMT_COUNTERVALUE
頭文件	#include <Pdh.h>
結構體說明	用於存儲性能計數器的數值。
相關函數	PdhGetFormattedCounterValue()、PdhCalculateCounterFromRawValue()
結構體聲明	struct PDH_FMT_COUNTERVALUE { DWORD CStatus; union { LONG longValue; double doubleValue; LONGLONG largeValue; LPCSTR AnsiStringValue; LPCWSTR WideStringValue; }; };
成員變量	CStatus：存放計數器數值的狀態碼，狀態碼錶示該數值是不是有效，0表示有效，非0表示無效，狀態碼能夠爲： PDH_CSTATUS_NO_MACHINE宏： PDH was unable to connect to the computer specified in the counter path. If this status is returned when the counter is being added, the counter is not completely initialized. Each time the query is updated, PDH retries the connection. When the connection is established, normal data collection resumes. PDH_CSTATUS_NO_OBJECT宏： The specified computer was found, but the specified performance object was found on the computer. If this status is returned when the counter is being added, the specified counter is not included in the query. If this status is returned by an active counter, the data for that counter is invalid. Each time the data is requested, PDH tries to obtain this counter data. PDH_CSTATUS_NO_INSTANCE宏： The specified instance was not found in the object. If this status is returned while the counter is being added to the query, the counter is successfully added to the query, but no data is available until the specific instance appears and a successful status is returned. PDH_CSTATUS_NO_COUNTER宏： The specified counter was not found in the specified object. If this status is returned when the counter is being added, then the counter is not added to the query. If this status is returned after data collection, the data for that counter is invalid. Each time the data is requested, PDH tries to obtain this counter data. PDH_CSTATUS_INVALID_DATA宏： The counter was successfully found, but the data returned is not valid. This error can occur if the counter value is less than the previous value. (Because counter values always increment, the counter value rolls over to zero when it reaches its maximum value.) Another possible cause is a system timer that is not correct. PDH_CSTATUS_VALID_DATA宏： The data for the counter was returned successfully, but is unchanged from the last time the counter was read. PDH_CSTATUS_NEW_DATA宏： The data for the counter was returned successfully and is different from the last time the counter was read. PDH_CSTATUS_NEW_DATA can be returned on a rate counter even if the resulting rate is the same as the last sample. This is because the raw data value that is used in the determination of this status value has changed, not the computed rate. PDH_MORE_DATA宏： The supplied buffer was not large enough to store all of the counter data. Allocate a larger buffer and execute the function again. PDH_CSTATUS_ITEM_NOT_VALIDATED宏： The counter has been added to the query, but has not been validated nor accessed. No additional status information on this counter is available. PDH_CSTATUS_NO_COUNTERNAME宏：查詢句柄中沒有指定計數器的名字。 PDH_CSTATUS_NO_COUNTER宏：指定的計數器的名字沒有找到。 PDH_CSTATUS_NO_OBJECT宏：指定的計數器的對象沒有找到。 PDH_CALC_NEGATIVE_DENOMINATOR宏：計數器具備分母值爲負數的值。 PDH_CALC_NEGATIVE_TIMEBASE宏：計數器具備時間基數爲負數的值。 PDH_CALC_NEGATIVE_VALUE宏：計數器具備負數的值。 PDH_CSTATUS_NO_COUNTERNAME宏：沒有指定計數器路徑字符串。 PDH_CSTATUS_BAD_COUNTERNAME宏：計數器路徑字符串的格式是不正確的。
	longValue：存放計數器數值爲LONG型的值。
	doubleValue：存放計數器數值爲DOUBLE型的值。
	largeValue：存放計數器數值爲LONGLONG型的值。
	AnsiStringValue：存放計數器數值爲ANSI字符串型的值。暫時未用。
	WideStringValue：存放計數器數值爲WIDE字符串型的值。暫時未用。
其餘說明	調用完收集函數並獲取計數器的數值成功後，還要判斷狀態碼是否爲有效，若是是狀態碼無效的，則表示獲取到的數值是不正確的，若是狀態碼是有效的，則表示獲取到的數值是正確的。根據調用獲取計數器的數值函數時指定的是什麼類型，來使用本結構體的哪一個成員變量，例如若是指定的是LONG型，那麼就使用longValue成員變量。

4.6 進程

4.6.1 PROCESS_INFORMATION

結構體名稱	PROCESS_INFORMATION
頭文件	#include <Windows.h>
結構體說明	進程信息結構體用於存放進程和主線程的標識和句柄。
相關函數	CreateProcess()、CreateProcessAsUser()、CreateProcessWithLogonW()、 CreateProcessWithTokenW()
結構體聲明	struct PROCESS_INFORMATION { HANDLE hProcess; HANDLE hThread; DWORD dwProcessId; DWORD dwThreadId; };
成員變量	hProcess：存放進程的句柄。
	hThread：存放主線程的句柄。
	dwProcessId：存放進程的標識。若是原進程退出後，本標識可能會分配給新進程。
	dwThreadId：存放主線程的標識。若是原線程退出後，本標識可能會分配給新線程。
其餘說明

4.7 文件

4.7.1 SHFILEOPSTRUCT(未完成)

結構體名稱

SHFILEOPSTRUCT

頭文件

#include <Shellapi.h>

結構體說明

Shell命令文件操做結構體用於針對SHFileOperation()函數的使用。

結構體聲明

struct SHFILEOPSTRUCT

{

HWND hwnd;

UINT wFunc;

PCZZTSTR pFrom;

PCZZTSTR pTo;

FILEOP_FLAGS fFlags;

BOOL fAnyOperationsAborted;

LPVOID hNameMappings;

PCTSTR lpszProgressTitle;

};

成員變量

hwnd：

存放執行文件操做時，顯示的操做過程窗口的父窗口句柄，爲0表示沒有父窗口，也就是桌面窗口。

wFunc：

存放具體執行哪一種文件操做的標記，能夠爲（選一至一個）：

FO_COPY：

把pFrom成員變量指定的文件或目錄複製到pTo成員變量指定的本地文件或目錄。

FO_DELETE：

刪除pFrom成員變量指定的單個文件或單個目錄。

FO_MOVE：

把pFrom成員變量指定的文件或目錄移動到pTo成員變量指定的本地文件或目錄。

FO_RENAME：

重命名pFrom成員變量指定的單個文件或單個目錄。

若是要重命名多個文件或多個目錄，可用FO_MOVE標記代替。

pFrom：

成員變量說明。

成員變量1：

成員變量說明。

成員變量1：

成員變量說明。

成員變量1：

成員變量說明。

成員變量1：

成員變量說明。

成員變量1：

成員變量說明。

其餘說明

……

4.8 窗口

4.8.1 RECT(未完成)

結構體名稱	RECT
頭文件	#include <Windows.h>
結構體說明	用於存放窗口的左邊、頂邊、右邊、底邊在屏幕上的位置。
相關函數	GetWindowRect()、Func2()、Func3()…
結構體聲明	struct RECT { LONG left; LONG top; LONG right; LONG bottom; };
成員變量	left：存放窗口的左邊在屏幕上的哪一個像素。
	top：存放窗口的頂邊在屏幕上的哪一個像素。
	right：存放窗口的右邊在屏幕上的哪一個像素。
	bottom：存放窗口的底邊在屏幕上的哪一個像素。
其餘說明

4.8.2 LVITEM(未完成)

結構體名稱

LVITEM

頭文件

#include <Commctrl.h>

結構體說明

存放列表控件中某個項目的某個字段的信息。

相關函數

CListCtrl::InsertItem()、CListCtrl::GetItem()、CListCtrl::SetItem()

結構體聲明

struct LVITEM

{

UINT mask;

int iItem;

int iSubItem;

UINT state;

UINT stateMask;

LPSTR pszText;

int cchTextMax;

int iImage;

LPARAM lParam;

int iIndent;

#if (NTDDI_VERSION >= NTDDI_WINXP)

int iGroupId;

UINT cColumns; // tile view columns

PUINT puColumns;

#endif

#if (NTDDI_VERSION >= NTDDI_VISTA) // Will be unused downlevel, but sizeof(LVITEMA) must be equal to sizeof(LVITEMW)

int* piColFmt;

int iGroup; // readonly. only valid for owner data.

#endif

};

成員變量

mask：

存放本函數有哪些參數有效的標記，能夠爲（用'|'選零至多個）：

LVIF_TEXT（0x00000001）：

若是設置本標記，表示pszText參數有效，也就是標籤字符串有效。

若是不設置本標記，表示項目沒有標籤。

LVIF_IMAGE（0x00000002）：

LVIF_PARAM（0x00000004）：

LVIF_STATE（0x00000008）：

LVIF_INDENT（0x00000010）：

LVIF_NORECOMPUTE（0x00000800）：

如下標記須要XP及之後的系統才支持：

LVIF_GROUPID（0x00000100）：

LVIF_COLUMNS（0x00000200）：

如下標記須要VISTA及之後的系統才支持：

LVIF_COLFMT（0x00010000）： // The piColFmt member is valid in addition to puColumns

iItem：

存放項目的項目索引號，本參數只能大於等於0。

iSubItem：

存放項目的字段索引號，本參數只能大於等於0。

state：

成員變量說明。

stateMask：

成員變量說明。

pszText：

存放項目的標籤字符串的內存指針。

在調用設置相關函數（例如：CListCtrl::InsertItem）時：

若是本成員變量爲NULL，就表示項目沒有標籤，列表控件上標籤位置顯示爲一片空白。

若是本成員變量爲LPSTR_TEXTCALLBACK宏，表示項目的標籤爲虛擬標籤。虛擬標籤是指列表控件不爲標籤字符串分配內存，當須要顯示標籤時，經過調用列表控件的LVN_GETDISPINFO消息響應函數來顯示。使用虛擬標籤能夠節約內存，並能夠快速插入並顯示大量項目，列表控件不會出現卡頓現象。詳情請參考LVN_GETDISPINFO消息。

cchTextMax：

存放項目的標籤字符串的內存的最大長度。

本參數只適用於調用獲取相關函數（例如：CListCtrl::GetItem）時，pszText參數指向的用於存放標籤字符串的內存的最大長度，不適用於調用設置相關函數（例如：CListCtrl::InsertItem）。

iImage：

成員變量說明。

lParam：

成員變量說明。

iIndent：

成員變量說明。

iGroupId：

成員變量說明。

cColumns：

成員變量說明。

puColumns：

成員變量說明。

piColFmt：

成員變量說明。

iGroup：

成員變量說明。

其餘說明

4.9 時鐘

4.9.1 timeval

結構體名稱	timeval
頭文件	#include <time.h>
結構體說明	用於記錄時間的結構體。
結構體聲明	struct timeval { time_t tv_sec; suseconds_t tv_usec; };
成員變量	tv_sec：表示多少秒。
成員變量	tv_usec：表示多少微秒，1秒等於1000000微秒。
其餘說明

4.9.2 timezone

結構體名稱	timezone
頭文件	#include <time.h>
結構體說明	用於記錄時區的結構體。
結構體聲明	struct timezone { int tz_minuteswest; int tz_dsttime; };
成員變量	tz_minuteswest：[輸入&輸出]，和格林威治時間往西方的時差，差了多少分鐘。 tz_dsttime：[輸入&輸出]，夏時制或夏令時或日光節約時（Daylight Saving Time）的類型。類型以下： DST_NONE //不使用 DST_USA //美國 DST_AUST //澳洲 DST_WET //西歐 DST_MET //中歐 DST_EET //東歐 DST_CAN //加拿大 DST_GB //大不列顛 DST_RUM //羅馬尼亞 DST_TUR //土耳其 DST_AUSTALT //澳洲（1986年之後）
其餘說明

4.9.3 tm

結構體名稱	tm
頭文件	#include <time.h>
結構體說明	存放日曆的結構體。
結構體聲明	struct tm { int tm_sec; int tm_min; int tm_hour; int tm_mday; int tm_mon; int tm_year; int tm_wday; int tm_yday; int tm_isdst; };
成員變量	tm_sec：表示秒鐘，在[0,60]之間，多出來的一秒是用來處理閏秒問題。 tm_min：表示分鐘，在[0,59]之間。 tm_hour：表示時鐘，在[0,23]之間。 tm_mday：表示日份，在[1,31]之間。 tm_mon：表示月份，在[0,11]之間。 tm_year：表示1900年到今年一共差多少年。 tm_wday：表示星期幾，在[0,6]之間，星期天爲0，星期一爲1，以此類推。 tm_yday：表示當天是本年第幾日，在[0,365]之間，非閏年有365日，閏年有366日。 tm_isdst：表示是否爲日光節約時間。
其餘說明

4.9.4 SYSTEMTIME

結構體名稱	SYSTEMTIME
頭文件	#include <Windows.h>
結構體說明	存放日期時間信息。
結構體聲明	typedef struct _SYSTEMTIME { WORD wYear; WORD wMonth; WORD wDayOfWeek; WORD wDay; WORD wHour; WORD wMinute; WORD wSecond; WORD wMilliseconds; }SYSTEMTIME;
成員變量	wYear：表示年份，在[1601-30827]之間。例如：此值爲2013，就表示2013年。 wMonth：表示月份，在[1-12]之間。例如：此值爲1，就表示1月；此值爲12，就表示12月。 wDayOfWeek：表示星期幾，在[1-7]之間。例如：此值爲1，就表示星期日；此值爲7，就表示星期六。 wDay：表示日份，在[1-31]之間。 wHour：表示時鐘，在[0-23]之間。 wMinute：表示分鐘，在[0-59]之間。 wSecond：表示秒鐘，在[0-59]之間。 wMilliseconds：表示毫秒，在[0-999]之間。
其餘說明

4.9.5 TIME_ZONE_INFORMATION(未完成)

結構體名稱	TIME_ZONE_INFORMATION
頭文件	#include <timezoneapi.h>
結構體說明	存放時區信息的結構體。
相關函數	GetTimeZoneInformation()、SetTimeZoneInformation()
結構體聲明	struct TIME_ZONE_INFORMATION { LONG Bias; WCHAR StandardName[32]; SYSTEMTIME StandardDate; LONG StandardBias; WCHAR DaylightName[32]; SYSTEMTIME DaylightDate; LONG DaylightBias; };
成員變量	Bias：存放本地時轉換爲協調時須要加減多少分鐘。例如：若是本地時區爲東八區，則本參數爲-480。
	StandardName：存放本地時區的標準名稱的字符串。例如：「中國標準時間」。本參數配置在如下注冊表中： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones 以中國北京時間爲例即 China Standard Time子項， Display：在控制面板中調整時區時顯示的名稱 Std：標準時間名稱 Dlt：若是有夏令時時區則爲其名稱。 Tzi：一個數據結構，包含本地時區和0時區相差的分鐘數等信息。二進制形式存儲的用一結構體定義之 typedef struct _REG_TZI_FORMAT { LONG Bias; 　　LONG StandardBias; 　　LONG DaylightBias; 　　SYSTEMTIME StandardDate; 　　SYSTEMTIME DaylightDate; }REG_TZI_FORMAT;
	StandardDate：成員變量說明。
	StandardBias：成員變量說明。
	DaylightName：成員變量說明。
	DaylightDate：成員變量說明。
	DaylightBias：成員變量說明。
其餘說明

4.10 消息機制

4.10.1 MSG

結構體名稱	MSG
頭文件	#include <Windows.h>
結構體說明	用於存放每個線程的消息隊列裏的消息的各項信息。
結構體聲明	struct MSG { HWND hwnd; UINT message; WPARAM wParam; LPARAM lParam; DWORD time; POINT pt; };
成員變量	hwnd：存放此條窗口消息是哪個窗口句柄的。若是不是窗口消息，此參數爲NULL。
	message：存放消息值，就是表示此條消息是什麼消息。例如：窗口消息多是WM_USER、WM_CHAR等，線程消息多是自定義的了。
	wParam：存放此條消息的第一個參數，具體做用根據不一樣的消息而定。
	lParam：存放此條消息的第二個參數，具體做用根據不一樣的消息而定。
	time：存放此條消息的發送時間。
	pt：存放此條消息在發送的時候，鼠標所在座標。注意：這不是接收此條消息時的座標，由於從消息的發送到接收是須要時間的。
其餘說明

4.11 音頻

4.11.1 WAVEFORMATEX(未完成)

結構體名稱	WAVEFORMATEX
頭文件	#include <mmeapi.h>
結構體稱呼	音頻格式結構體。
結構體說明	用於存放音頻數據格式的相關參數。
相關函數	waveInOpen()、Func2()、Func3()…
結構體聲明	struct WAVEFORMATEX { WORD wFormatTag; /* format type / WORD nChannels; / number of channels (i.e. mono, stereo...) / DWORD nSamplesPerSec; / sample rate / DWORD nAvgBytesPerSec; / for buffer estimation / WORD nBlockAlign; / block size of data / WORD wBitsPerSample; / number of bits per sample of mono data / WORD cbSize; / the count in bytes of the size of / / extra information (after cbSize) */ };
成員變量	wFormatTag：存放音頻的格式，通常選WAVE_FORMAT_PCM宏表示原始格式，能夠爲（選一至一個）： *WAVE_FORMAT_UNKNOWN 0x0000 / Microsoft Corporation /* *WAVE_FORMAT_PCM 0x0001 / raw format /* *WAVE_FORMAT_ADPCM 0x0002 / Microsoft Corporation /* *WAVE_FORMAT_IEEE_FLOAT 0x0003 / Microsoft Corporation /* *WAVE_FORMAT_VSELP 0x0004 / Compaq Computer Corp. /* *WAVE_FORMAT_IBM_CVSD 0x0005 / IBM Corporation /* *WAVE_FORMAT_ALAW 0x0006 / Microsoft Corporation /* *WAVE_FORMAT_MULAW 0x0007 / Microsoft Corporation /* *WAVE_FORMAT_DTS 0x0008 / Microsoft Corporation /* *WAVE_FORMAT_DRM 0x0009 / Microsoft Corporation /* *WAVE_FORMAT_WMAVOICE9 0x000A / Microsoft Corporation /* *WAVE_FORMAT_WMAVOICE10 0x000B / Microsoft Corporation /* *WAVE_FORMAT_OKI_ADPCM 0x0010 / OKI /* *WAVE_FORMAT_DVI_ADPCM 0x0011 / Intel Corporation /* *WAVE_FORMAT_IMA_ADPCM (WAVE_FORMAT_DVI_ADPCM) / Intel Corporation /* *WAVE_FORMAT_MEDIASPACE_ADPCM 0x0012 / Videologic /* *WAVE_FORMAT_SIERRA_ADPCM 0x0013 / Sierra Semiconductor Corp /* *WAVE_FORMAT_G723_ADPCM 0x0014 / Antex Electronics Corporation /* *WAVE_FORMAT_DIGISTD 0x0015 / DSP Solutions, Inc. /* *WAVE_FORMAT_DIGIFIX 0x0016 / DSP Solutions, Inc. /* *WAVE_FORMAT_DIALOGIC_OKI_ADPCM 0x0017 / Dialogic Corporation /* *WAVE_FORMAT_MEDIAVISION_ADPCM 0x0018 / Media Vision, Inc. /* *WAVE_FORMAT_CU_CODEC 0x0019 / Hewlett-Packard Company /* *WAVE_FORMAT_HP_DYN_VOICE 0x001A / Hewlett-Packard Company /* *WAVE_FORMAT_YAMAHA_ADPCM 0x0020 / Yamaha Corporation of America /* *WAVE_FORMAT_SONARC 0x0021 / Speech Compression /* *WAVE_FORMAT_DSPGROUP_TRUESPEECH 0x0022 / DSP Group, Inc /* *WAVE_FORMAT_ECHOSC1 0x0023 / Echo Speech Corporation /* *WAVE_FORMAT_AUDIOFILE_AF36 0x0024 / Virtual Music, Inc. /* *WAVE_FORMAT_APTX 0x0025 / Audio Processing Technology /* *WAVE_FORMAT_AUDIOFILE_AF10 0x0026 / Virtual Music, Inc. /* *WAVE_FORMAT_PROSODY_1612 0x0027 / Aculab plc /* *WAVE_FORMAT_LRC 0x0028 / Merging Technologies S.A. /* *WAVE_FORMAT_DOLBY_AC2 0x0030 / Dolby Laboratories /* *WAVE_FORMAT_GSM610 0x0031 / Microsoft Corporation /* *WAVE_FORMAT_MSNAUDIO 0x0032 / Microsoft Corporation /* *WAVE_FORMAT_ANTEX_ADPCME 0x0033 / Antex Electronics Corporation /* *WAVE_FORMAT_CONTROL_RES_VQLPC 0x0034 / Control Resources Limited /* *WAVE_FORMAT_DIGIREAL 0x0035 / DSP Solutions, Inc. /* *WAVE_FORMAT_DIGIADPCM 0x0036 / DSP Solutions, Inc. /* *WAVE_FORMAT_CONTROL_RES_CR10 0x0037 / Control Resources Limited /* *WAVE_FORMAT_NMS_VBXADPCM 0x0038 / Natural MicroSystems /* *WAVE_FORMAT_CS_IMAADPCM 0x0039 / Crystal Semiconductor IMA ADPCM /* *WAVE_FORMAT_ECHOSC3 0x003A / Echo Speech Corporation /* *WAVE_FORMAT_ROCKWELL_ADPCM 0x003B / Rockwell International /* *WAVE_FORMAT_ROCKWELL_DIGITALK 0x003C / Rockwell International /* *WAVE_FORMAT_XEBEC 0x003D / Xebec Multimedia Solutions Limited /* *WAVE_FORMAT_G721_ADPCM 0x0040 / Antex Electronics Corporation /* *WAVE_FORMAT_G728_CELP 0x0041 / Antex Electronics Corporation /* *WAVE_FORMAT_MSG723 0x0042 / Microsoft Corporation /* *WAVE_FORMAT_INTEL_G723_1 0x0043 / Intel Corp. /* *WAVE_FORMAT_INTEL_G729 0x0044 / Intel Corp. /* *WAVE_FORMAT_SHARP_G726 0x0045 / Sharp /* *WAVE_FORMAT_MPEG 0x0050 / Microsoft Corporation /* *WAVE_FORMAT_RT24 0x0052 / InSoft, Inc. /* *WAVE_FORMAT_PAC 0x0053 / InSoft, Inc. /* *WAVE_FORMAT_MPEGLAYER3 0x0055 / ISO/MPEG Layer3 Format Tag /* *WAVE_FORMAT_LUCENT_G723 0x0059 / Lucent Technologies /* *WAVE_FORMAT_CIRRUS 0x0060 / Cirrus Logic /* *WAVE_FORMAT_ESPCM 0x0061 / ESS Technology /* *WAVE_FORMAT_VOXWARE 0x0062 / Voxware Inc /* *WAVE_FORMAT_CANOPUS_ATRAC 0x0063 / Canopus, co., Ltd. /* *WAVE_FORMAT_G726_ADPCM 0x0064 / APICOM /* *WAVE_FORMAT_G722_ADPCM 0x0065 / APICOM /* *WAVE_FORMAT_DSAT 0x0066 / Microsoft Corporation /* *WAVE_FORMAT_DSAT_DISPLAY 0x0067 / Microsoft Corporation /* *WAVE_FORMAT_VOXWARE_BYTE_ALIGNED 0x0069 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_AC8 0x0070 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_AC10 0x0071 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_AC16 0x0072 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_AC20 0x0073 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_RT24 0x0074 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_RT29 0x0075 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_RT29HW 0x0076 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_VR12 0x0077 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_VR18 0x0078 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_TQ40 0x0079 / Voxware Inc /* *WAVE_FORMAT_VOXWARE_SC3 0x007A / Voxware Inc /* *WAVE_FORMAT_VOXWARE_SC3_1 0x007B / Voxware Inc /* *WAVE_FORMAT_SOFTSOUND 0x0080 / Softsound, Ltd. /* *WAVE_FORMAT_VOXWARE_TQ60 0x0081 / Voxware Inc /* *WAVE_FORMAT_MSRT24 0x0082 / Microsoft Corporation /* *WAVE_FORMAT_G729A 0x0083 / AT&T Labs, Inc. /* *WAVE_FORMAT_MVI_MVI2 0x0084 / Motion Pixels /* *WAVE_FORMAT_DF_G726 0x0085 / DataFusion Systems (Pty) (Ltd) /* *WAVE_FORMAT_DF_GSM610 0x0086 / DataFusion Systems (Pty) (Ltd) /* *WAVE_FORMAT_ISIAUDIO 0x0088 / Iterated Systems, Inc. /* *WAVE_FORMAT_ONLIVE 0x0089 / OnLive! Technologies, Inc. /* *WAVE_FORMAT_MULTITUDE_FT_SX20 0x008A / Multitude Inc. /* *WAVE_FORMAT_INFOCOM_ITS_G721_ADPCM 0x008B / Infocom /* *WAVE_FORMAT_CONVEDIA_G729 0x008C / Convedia Corp. /* *WAVE_FORMAT_CONGRUENCY 0x008D / Congruency Inc. /* *WAVE_FORMAT_SBC24 0x0091 / Siemens Business Communications Sys /* *WAVE_FORMAT_DOLBY_AC3_SPDIF 0x0092 / Sonic Foundry /* *WAVE_FORMAT_MEDIASONIC_G723 0x0093 / MediaSonic /* *WAVE_FORMAT_PROSODY_8KBPS 0x0094 / Aculab plc /* *WAVE_FORMAT_ZYXEL_ADPCM 0x0097 / ZyXEL Communications, Inc. /* *WAVE_FORMAT_PHILIPS_LPCBB 0x0098 / Philips Speech Processing /* *WAVE_FORMAT_PACKED 0x0099 / Studer Professional Audio AG /* *WAVE_FORMAT_MALDEN_PHONYTALK 0x00A0 / Malden Electronics Ltd. /* *WAVE_FORMAT_RACAL_RECORDER_GSM 0x00A1 / Racal recorders /* *WAVE_FORMAT_RACAL_RECORDER_G720_A 0x00A2 / Racal recorders /* *WAVE_FORMAT_RACAL_RECORDER_G723_1 0x00A3 / Racal recorders /* *WAVE_FORMAT_RACAL_RECORDER_TETRA_ACELP 0x00A4 / Racal recorders /* *WAVE_FORMAT_NEC_AAC 0x00B0 / NEC Corp. /* *WAVE_FORMAT_RAW_AAC1 0x00FF / For Raw AAC, with format block AudioSpecificConfig() (as defined by MPEG-4), that follows WAVEFORMATEX /* *WAVE_FORMAT_RHETOREX_ADPCM 0x0100 / Rhetorex Inc. /* *WAVE_FORMAT_IRAT 0x0101 / BeCubed Software Inc. /* *WAVE_FORMAT_VIVO_G723 0x0111 / Vivo Software /* *WAVE_FORMAT_VIVO_SIREN 0x0112 / Vivo Software /* *WAVE_FORMAT_PHILIPS_CELP 0x0120 / Philips Speech Processing /* *WAVE_FORMAT_PHILIPS_GRUNDIG 0x0121 / Philips Speech Processing /* *WAVE_FORMAT_DIGITAL_G723 0x0123 / Digital Equipment Corporation /* *WAVE_FORMAT_SANYO_LD_ADPCM 0x0125 / Sanyo Electric Co., Ltd. /* *WAVE_FORMAT_SIPROLAB_ACEPLNET 0x0130 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_SIPROLAB_ACELP4800 0x0131 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_SIPROLAB_ACELP8V3 0x0132 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_SIPROLAB_G729 0x0133 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_SIPROLAB_G729A 0x0134 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_SIPROLAB_KELVIN 0x0135 / Sipro Lab Telecom Inc. /* *WAVE_FORMAT_VOICEAGE_AMR 0x0136 / VoiceAge Corp. /* *WAVE_FORMAT_G726ADPCM 0x0140 / Dictaphone Corporation /* *WAVE_FORMAT_DICTAPHONE_CELP68 0x0141 / Dictaphone Corporation /* *WAVE_FORMAT_DICTAPHONE_CELP54 0x0142 / Dictaphone Corporation /* *WAVE_FORMAT_QUALCOMM_PUREVOICE 0x0150 / Qualcomm, Inc. /* *WAVE_FORMAT_QUALCOMM_HALFRATE 0x0151 / Qualcomm, Inc. /* *WAVE_FORMAT_TUBGSM 0x0155 / Ring Zero Systems, Inc. /* *WAVE_FORMAT_MSAUDIO1 0x0160 / Microsoft Corporation /* *WAVE_FORMAT_WMAUDIO2 0x0161 / Microsoft Corporation /* *WAVE_FORMAT_WMAUDIO3 0x0162 / Microsoft Corporation /* *WAVE_FORMAT_WMAUDIO_LOSSLESS 0x0163 / Microsoft Corporation /* *WAVE_FORMAT_WMASPDIF 0x0164 / Microsoft Corporation /* *WAVE_FORMAT_UNISYS_NAP_ADPCM 0x0170 / Unisys Corp. /* *WAVE_FORMAT_UNISYS_NAP_ULAW 0x0171 / Unisys Corp. /* *WAVE_FORMAT_UNISYS_NAP_ALAW 0x0172 / Unisys Corp. /* *WAVE_FORMAT_UNISYS_NAP_16K 0x0173 / Unisys Corp. /* *WAVE_FORMAT_SYCOM_ACM_SYC008 0x0174 / SyCom Technologies /* *WAVE_FORMAT_SYCOM_ACM_SYC701_G726L 0x0175 / SyCom Technologies /* *WAVE_FORMAT_SYCOM_ACM_SYC701_CELP54 0x0176 / SyCom Technologies /* *WAVE_FORMAT_SYCOM_ACM_SYC701_CELP68 0x0177 / SyCom Technologies /* *WAVE_FORMAT_KNOWLEDGE_ADVENTURE_ADPCM 0x0178 / Knowledge Adventure, Inc. /* *WAVE_FORMAT_FRAUNHOFER_IIS_MPEG2_AAC 0x0180 / Fraunhofer IIS /* *WAVE_FORMAT_DTS_DS 0x0190 / Digital Theatre Systems, Inc. /* *WAVE_FORMAT_CREATIVE_ADPCM 0x0200 / Creative Labs, Inc /* *WAVE_FORMAT_CREATIVE_FASTSPEECH8 0x0202 / Creative Labs, Inc /* *WAVE_FORMAT_CREATIVE_FASTSPEECH10 0x0203 / Creative Labs, Inc /* *WAVE_FORMAT_UHER_ADPCM 0x0210 / UHER informatic GmbH /* *WAVE_FORMAT_ULEAD_DV_AUDIO 0x0215 / Ulead Systems, Inc. /* *WAVE_FORMAT_ULEAD_DV_AUDIO_1 0x0216 / Ulead Systems, Inc. /* *WAVE_FORMAT_QUARTERDECK 0x0220 / Quarterdeck Corporation /* *WAVE_FORMAT_ILINK_VC 0x0230 / I-link Worldwide /* *WAVE_FORMAT_RAW_SPORT 0x0240 / Aureal Semiconductor /* *WAVE_FORMAT_ESST_AC3 0x0241 / ESS Technology, Inc. /* WAVE_FORMAT_GENERIC_PASSTHRU 0x0249 *WAVE_FORMAT_IPI_HSX 0x0250 / Interactive Products, Inc. /* *WAVE_FORMAT_IPI_RPELP 0x0251 / Interactive Products, Inc. /* *WAVE_FORMAT_CS2 0x0260 / Consistent Software /* *WAVE_FORMAT_SONY_SCX 0x0270 / Sony Corp. /* *WAVE_FORMAT_SONY_SCY 0x0271 / Sony Corp. /* *WAVE_FORMAT_SONY_ATRAC3 0x0272 / Sony Corp. /* *WAVE_FORMAT_SONY_SPC 0x0273 / Sony Corp. /* *WAVE_FORMAT_TELUM_AUDIO 0x0280 / Telum Inc. /* *WAVE_FORMAT_TELUM_IA_AUDIO 0x0281 / Telum Inc. /* *WAVE_FORMAT_NORCOM_VOICE_SYSTEMS_ADPCM 0x0285 / Norcom Electronics Corp. /* *WAVE_FORMAT_FM_TOWNS_SND 0x0300 / Fujitsu Corp. /* *WAVE_FORMAT_MICRONAS 0x0350 / Micronas Semiconductors, Inc. /* *WAVE_FORMAT_MICRONAS_CELP833 0x0351 / Micronas Semiconductors, Inc. /* *WAVE_FORMAT_BTV_DIGITAL 0x0400 / Brooktree Corporation /* *WAVE_FORMAT_INTEL_MUSIC_CODER 0x0401 / Intel Corp. /* *WAVE_FORMAT_INDEO_AUDIO 0x0402 / Ligos /* *WAVE_FORMAT_QDESIGN_MUSIC 0x0450 / QDesign Corporation /* *WAVE_FORMAT_ON2_VP7_AUDIO 0x0500 / On2 Technologies /* *WAVE_FORMAT_ON2_VP6_AUDIO 0x0501 / On2 Technologies /* *WAVE_FORMAT_VME_VMPCM 0x0680 / AT&T Labs, Inc. /* *WAVE_FORMAT_TPC 0x0681 / AT&T Labs, Inc. /* *WAVE_FORMAT_LIGHTWAVE_LOSSLESS 0x08AE / Clearjump /* *WAVE_FORMAT_OLIGSM 0x1000 / Ing C. Olivetti & C., S.p.A. /* *WAVE_FORMAT_OLIADPCM 0x1001 / Ing C. Olivetti & C., S.p.A. /* *WAVE_FORMAT_OLICELP 0x1002 / Ing C. Olivetti & C., S.p.A. /* *WAVE_FORMAT_OLISBC 0x1003 / Ing C. Olivetti & C., S.p.A. /* *WAVE_FORMAT_OLIOPR 0x1004 / Ing C. Olivetti & C., S.p.A. /* *WAVE_FORMAT_LH_CODEC 0x1100 / Lernout & Hauspie /* *WAVE_FORMAT_LH_CODEC_CELP 0x1101 / Lernout & Hauspie /* *WAVE_FORMAT_LH_CODEC_SBC8 0x1102 / Lernout & Hauspie /* *WAVE_FORMAT_LH_CODEC_SBC12 0x1103 / Lernout & Hauspie /* *WAVE_FORMAT_LH_CODEC_SBC16 0x1104 / Lernout & Hauspie /* *WAVE_FORMAT_NORRIS 0x1400 / Norris Communications, Inc. /* *WAVE_FORMAT_ISIAUDIO_2 0x1401 / ISIAudio /* *WAVE_FORMAT_SOUNDSPACE_MUSICOMPRESS 0x1500 / AT&T Labs, Inc. /* *WAVE_FORMAT_MPEG_ADTS_AAC 0x1600 / Microsoft Corporation /* *WAVE_FORMAT_MPEG_RAW_AAC 0x1601 / Microsoft Corporation /* *WAVE_FORMAT_MPEG_LOAS 0x1602 / Microsoft Corporation (MPEG-4 Audio Transport Streams (LOAS/LATM) /* *WAVE_FORMAT_NOKIA_MPEG_ADTS_AAC 0x1608 / Microsoft Corporation /* *WAVE_FORMAT_NOKIA_MPEG_RAW_AAC 0x1609 / Microsoft Corporation /* *WAVE_FORMAT_VODAFONE_MPEG_ADTS_AAC 0x160A / Microsoft Corporation /* *WAVE_FORMAT_VODAFONE_MPEG_RAW_AAC 0x160B / Microsoft Corporation /* WAVE_FORMAT_MPEG_HEAAC 0x1610 /* Microsoft Corporation (MPEG-2 AAC or MPEG-4 HE-AAC v1/v2 streams with any payload (ADTS, ADIF, LOAS/LATM, RAW). Format block includes MP4 AudioSpecificConfig() -- see HEAACWAVEFORMAT below / WAVE_FORMAT_VOXWARE_RT24_SPEECH 0x181C / Voxware Inc. /* *WAVE_FORMAT_SONICFOUNDRY_LOSSLESS 0x1971 / Sonic Foundry /* *WAVE_FORMAT_INNINGS_TELECOM_ADPCM 0x1979 / Innings Telecom Inc. /* *WAVE_FORMAT_LUCENT_SX8300P 0x1C07 / Lucent Technologies /* *WAVE_FORMAT_LUCENT_SX5363S 0x1C0C / Lucent Technologies /* *WAVE_FORMAT_CUSEEME 0x1F03 / CUSeeMe /* *WAVE_FORMAT_NTCSOFT_ALF2CM_ACM 0x1FC4 / NTCSoft /* *WAVE_FORMAT_DVM 0x2000 / FAST Multimedia AG /* WAVE_FORMAT_DTS2 0x2001 WAVE_FORMAT_MAKEAVIS 0x3313 *WAVE_FORMAT_DIVIO_MPEG4_AAC 0x4143 / Divio, Inc. /* *WAVE_FORMAT_NOKIA_ADAPTIVE_MULTIRATE 0x4201 / Nokia /* *WAVE_FORMAT_DIVIO_G726 0x4243 / Divio, Inc. /* *WAVE_FORMAT_LEAD_SPEECH 0x434C / LEAD Technologies /* *WAVE_FORMAT_LEAD_VORBIS 0x564C / LEAD Technologies /* *WAVE_FORMAT_WAVPACK_AUDIO 0x5756 / xiph.org /* *WAVE_FORMAT_OGG_VORBIS_MODE_1 0x674F / Ogg Vorbis /* *WAVE_FORMAT_OGG_VORBIS_MODE_2 0x6750 / Ogg Vorbis /* *WAVE_FORMAT_OGG_VORBIS_MODE_3 0x6751 / Ogg Vorbis /* *WAVE_FORMAT_OGG_VORBIS_MODE_1_PLUS 0x676F / Ogg Vorbis /* *WAVE_FORMAT_OGG_VORBIS_MODE_2_PLUS 0x6770 / Ogg Vorbis /* *WAVE_FORMAT_OGG_VORBIS_MODE_3_PLUS 0x6771 / Ogg Vorbis /* *WAVE_FORMAT_3COM_NBX 0x7000 / 3COM Corp. /* WAVE_FORMAT_FAAD_AAC 0x706D *WAVE_FORMAT_AMR_NB 0x7361 / AMR Narrowband /* *WAVE_FORMAT_AMR_WB 0x7362 / AMR Wideband /* *WAVE_FORMAT_AMR_WP 0x7363 / AMR Wideband Plus /* *WAVE_FORMAT_GSM_AMR_CBR 0x7A21 / GSMA/3GPP /* *WAVE_FORMAT_GSM_AMR_VBR_SID 0x7A22 / GSMA/3GPP /* *WAVE_FORMAT_COMVERSE_INFOSYS_G723_1 0xA100 / Comverse Infosys /* *WAVE_FORMAT_COMVERSE_INFOSYS_AVQSBC 0xA101 / Comverse Infosys /* *WAVE_FORMAT_COMVERSE_INFOSYS_SBC 0xA102 / Comverse Infosys /* *WAVE_FORMAT_SYMBOL_G729_A 0xA103 / Symbol Technologies /* *WAVE_FORMAT_VOICEAGE_AMR_WB 0xA104 / VoiceAge Corp. /* *WAVE_FORMAT_INGENIENT_G726 0xA105 / Ingenient Technologies, Inc. /* *WAVE_FORMAT_MPEG4_AAC 0xA106 / ISO/MPEG-4 /* *WAVE_FORMAT_ENCORE_G726 0xA107 / Encore Software /* *WAVE_FORMAT_ZOLL_ASAO 0xA108 / ZOLL Medical Corp. /* *WAVE_FORMAT_SPEEX_VOICE 0xA109 / xiph.org /* *WAVE_FORMAT_VIANIX_MASC 0xA10A / Vianix LLC /* *WAVE_FORMAT_WM9_SPECTRUM_ANALYZER 0xA10B / Microsoft /* *WAVE_FORMAT_WMF_SPECTRUM_ANAYZER 0xA10C / Microsoft /* WAVE_FORMAT_GSM_610 0xA10D WAVE_FORMAT_GSM_620 0xA10E WAVE_FORMAT_GSM_660 0xA10F WAVE_FORMAT_GSM_690 0xA110 WAVE_FORMAT_GSM_ADAPTIVE_MULTIRATE_WB 0xA111 *WAVE_FORMAT_POLYCOM_G722 0xA112 / Polycom /* *WAVE_FORMAT_POLYCOM_G728 0xA113 / Polycom /* *WAVE_FORMAT_POLYCOM_G729_A 0xA114 / Polycom /* *WAVE_FORMAT_POLYCOM_SIREN 0xA115 / Polycom /* *WAVE_FORMAT_GLOBAL_IP_ILBC 0xA116 / Global IP /* *WAVE_FORMAT_RADIOTIME_TIME_SHIFT_RADIO 0xA117 / RadioTime /* *WAVE_FORMAT_NICE_ACA 0xA118 / Nice Systems /* *WAVE_FORMAT_NICE_ADPCM 0xA119 / Nice Systems /* *WAVE_FORMAT_VOCORD_G721 0xA11A / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G726 0xA11B / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G722_1 0xA11C / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G728 0xA11D / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G729 0xA11E / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G729_A 0xA11F / Vocord Telecom /* *WAVE_FORMAT_VOCORD_G723_1 0xA120 / Vocord Telecom /* *WAVE_FORMAT_VOCORD_LBC 0xA121 / Vocord Telecom /* *WAVE_FORMAT_NICE_G728 0xA122 / Nice Systems /* *WAVE_FORMAT_FRACE_TELECOM_G729 0xA123 / France Telecom /* *WAVE_FORMAT_CODIAN 0xA124 / CODIAN /* *WAVE_FORMAT_FLAC 0xF1AC / flac.sourceforge.net /* *WAVE_FORMAT_EXTENSIBLE 0xFFFE / Microsoft /*
	nChannels：存放音頻的聲道數量，1表示單聲道，2表示雙聲道立體聲。
	nSamplesPerSec：存放音頻的採樣頻率，單位赫茲。若是wFormatTag參數爲WAVE_FORMAT_PCM宏，本參數能夠爲8000、1102五、22050、44100。對於非PCM格式請根據廠商的說明設置本參數。
	nAvgBytesPerSec：存放音頻的平均數據傳輸速率，單位字節每秒。這個值對於建立緩衝大小是頗有用的。若是wFormatTag參數爲WAVE_FORMAT_PCM宏，本參數應與nSamplesPerSec參數相同。對於非PCM格式請根據廠商的說明設置本參數。
	nBlockAlign：存放音頻的採樣單元的大小，也就是每一次採樣到的音頻數據單元的大小，單位字節，計算方法：聲道數量×採樣位數÷8。若是wFormatTag參數爲WAVE_FORMAT_PCM宏，本參數爲(nChannels * wBitsPerSample) / 8。對於非PCM格式請根據廠商的說明設置本參數。
	wBitsPerSample：存放音頻的採樣位數，單位比特位。若是wFormatTag參數爲WAVE_FORMAT_PCM宏，本參數能夠爲八、16。對於非PCM格式請根據廠商的說明設置本參數。
	cbSize：存放音頻的額外信息的大小，單位字節，額外信息添加在WAVEFORMATEX結構的結尾。這個信息能夠做爲非PCM格式的wFormatTag額外屬性。若是wFormatTag參數指定的音頻格式不須要額外的信息，此值必需爲0。若是wFormatTag參數爲WAVE_FORMAT_PCM宏，本參數無心義。
其餘說明	一個使用額外信息的例子，微軟自適應音頻脈衝編碼（ms-adpcm）格式，對於ms-adpcm的wformattag參數爲WAVE_FORMAT_ADPCM宏。cbSize參數一般會被設置爲2(16位)。存儲ms-adpcm格式的額外信息係數對編碼和波形音頻數據解碼所需。

4.11.2 WAVEHDR(未完成)

結構體名稱	WAVEHDR
頭文件	#include <mmeapi.h>
結構體說明	音頻數據塊結構體，用於存放音頻輸入設備和播放設備的一個音頻數據塊。
相關函數	waveInPrepareHeader()、Func2()、Func3()…
結構體聲明	struct WAVEHDR { LPSTR lpData; /* pointer to locked data buffer / DWORD dwBufferLength; / length of data buffer / DWORD dwBytesRecorded; / used for input only / DWORD_PTR dwUser; / for client's use / DWORD dwFlags; / assorted flags (see defines) / DWORD dwLoops; / loop control counter / struct WAVEHDR lpNext; /* reserved for driver / DWORD_PTR reserved; / reserved for driver */ };
成員變量	lpData：存放音頻數據塊的實際數據數組的內存指針。
	dwBufferLength：存放音頻數據塊的實際數據數組的內存長度，單位字節。
	dwBytesRecorded：存放在音頻數據塊的實際數據數組中，實際數據的內存長度，單位字節。
	dwUser：存放音頻的額外信息。若是音頻的格式爲PCM格式，本參數無心義。
	dwFlags：存放音頻數據塊的控制標記，能夠爲（用'\|'選零至多個）： WHDR_DONE宏(0x0001)：Set by the device driver to indicate that it is finished with the buffer and is returning it to the application. WHDR_PREPARED宏(0x0002)：Set by Windows to indicate that the buffer has been prepared with the waveInPrepareHeader or waveOutPrepareHeader function. WHDR_BEGINLOOP宏(0x0004)：This buffer is the first buffer in a loop. This flag is used only with output buffers. WHDR_ENDLOOP宏(0x0008)：This buffer is the last buffer in a loop. This flag is used only with output buffers. WHDR_INQUEUE宏(0x0010)：Set by Windows to indicate that the buffer is queued for playback.
	dwLoops：存放播放循環次數，本參數只針對播放設備有效，音頻輸入設備無心義。
	lpNext：本參數無心義。
	reserved：本參數無心義。
其餘說明

5 errno錯誤碼

注意：數值在不一樣的操做系統上可能不同。

EPERM (1) /* Operation not permitted */

ENOENT (2) /* No such file or directory */

ESRCH (3) /* No such process */

EINTR (4) /* Interrupted system call */

EIO (5) /* Input/output error */

ENXIO (6) /* No such device or address */

E2BIG (7) /* Argument list too long */

ENOEXEC (8) /* Exec format error */

EBADF (9) /* Bad file descriptor */

ECHILD (10)/* No child processes */

EDEADLK (11)/* Resource deadlock avoided */

ENOMEM (12)/* Cannot allocate memory */

EACCES (13)/* Permission denied */

EFAULT (14)/* Bad address */

ENOTBLK (15)/* Block device required */

EBUSY (16)/* Device or resource busy */

EEXIST (17)/* File exists */

EXDEV (18)/* Invalid cross-device link */

ENODEV (19)/* No such device */

ENOTDIR (20)/* Not a directory */

EISDIR (21)/* Is a directory */

EINVAL (22)/* Invalid argument */

EMFILE (24)/* Too many open files */

ENFILE (23)/* Too many open files in system */

ENOTTY (25)/* Inappropriate ioctl for device */

ETXTBSY (26)/* Text file busy */

EFBIG (27)/* File too large */

ENOSPC (28)/* No space left on device */

ESPIPE (29)/* Illegal seek */

EROFS (30)/* Read-only file system */

EMLINK (31)/* Too many links */

EPIPE (32)/* Broken pipe */

EDOM (33)/* Numerical argument out of domain */

ERANGE (34)/* Numerical result out of range */

EAGAIN (35)/* Resource temporarily unavailable */

EWOULDBLOCK EAGAIN /* Operation would block */

EINPROGRESS (36)/* Operation now in progress */

EALREADY (37)/* Operation already in progress */

ENOTSOCK (38)/* Socket operation on non-socket */

EDESTADDRREQ (39)/* Destination address required */

EMSGSIZE (40)/* Message too long */

EPROTOTYPE (41)/* Protocol wrong type for socket */

ENOPROTOOPT (42)/* Protocol not available */

EPROTONOSUPPORT (43)/* Protocol not supported */

ESOCKTNOSUPPORT (44)/* Socket type not supported */

EOPNOTSUPP (45)/* Operation not supported */

EPFNOSUPPORT (46)/* Protocol family not supported */

EAFNOSUPPORT (47)/* Address family not supported by protocol */

EADDRINUSE (48)/* Address already in use */

EADDRNOTAVAIL (49)/* Cannot assign requested address */

ENETDOWN (50)/* Network is down */

ENETUNREACH (51)/* Network is unreachable */

ENETRESET (52)/* Network dropped connection on reset */

ECONNABORTED (53)/* Software caused connection abort */

ECONNRESET (54)/* Connection reset by peer */

ENOBUFS (55)/* No buffer space available */

EISCONN (56)/* Transport endpoint is already connected */

ENOTCONN (57)/* Transport endpoint is not connected */

ESHUTDOWN (58)/* Cannot send after transport endpoint shutdown */

ETOOMANYREFS (59)/* Too many references: cannot splice */

ETIMEDOUT (60)/* Connection timed out */

ECONNREFUSED (61)/* Connection refused */

ELOOP (62)/* Too many levels of symbolic links */

ENAMETOOLONG (63)/* File name too long */

EHOSTDOWN (64)/* Host is down */

EHOSTUNREACH (65)/* No route to host */

ENOTEMPTY (66)/* Directory not empty */

EPROCLIM (67)/* Too many processes */

EUSERS (68)/* Too many users */

EDQUOT (69)/* Disk quota exceeded */

ESTALE (70)/* Stale NFS file handle */

EREMOTE (71)/* Object is remote */

EBADRPC (72)/* RPC struct is bad */

ERPCMISMATCH (73)/* RPC version wrong */

EPROGUNAVAIL (74)/* RPC program not available */

EPROGMISMATCH (75)/* RPC program version wrong */

EPROCUNAVAIL (76)/* RPC bad procedure for program */

ENOLCK (77)/* No locks available */

ENOSYS (78)/* Function not implemented */

EFTYPE (79)/* Inappropriate file type or format */

EAUTH (80)/* Authentication error */

ENEEDAUTH (81)/* Need authenticator */

ELAST (81)/* Must be equal largest errno */

EBACKGROUND (100)/* Inappropriate operation for background process */

EDIED (101)/* Translator died */

ED (102)/* ? */

EGREGIOUS (103)/* You really blew it this time */

EIEIO (104)/* Computer bought the farm */

EGRATUITOUS (105)/* Gratuitous error */

EILSEQ (106)/* Invalid or incomplete multibyte or wide character */

EBADMSG (107)/* Bad message */

EIDRM (108)/* Identifier removed */

EMULTIHOP (109)/* Multihop attempted */

ENODATA (110)/* No data available */

ENOLINK (111)/* Link has been severed */

ENOMSG (112)/* No message of desired type */

ENOSR (113)/* Out of streams resources */

ENOSTR (114)/* Device not a stream */

EOVERFLOW (115)/* Value too large for defined data type */

EPROTO (116)/* Protocol error */

ETIME (117)/* Timer expired */

ECANCELED (118)/* Operation canceled */

ENOTSUP (118)/* Not supported */

6 轉義字符

字符	十進制	十六進制	對應按鍵	名稱	Windows控制檯下輸出效果	例子
\a	7	0x7	無	響鈴符(BEL)	在支持的設備(終端)上鳴響一聲
\b	8	0x8	Backspace 退格	退格符(BS)	光標在當前位置左移一格
\f	12	0xC	無	分頁符(FF)	打印機跳到下一頁打印
\n	10	0xA	Enter 回車	回車換行符(LF)	光標跳到下一行行首
\r	13	0xD	無	回車符(CR)	光標回到當前行首	printf("123456\rABC"); 屏幕上輸出：ABC456
\t	9	0x9	Tab 製表	水平製表符(HT)	光標水平跳到下一個製表位
\v	11	0xB	無	垂直製表符(VT)	不支持
\?	63	0x3F	? 問號		打印一個‘?’	正確：printf("\?"); printf("?");
\\	92	0x5C	\ 反斜槓		打印一個‘\’	正確：printf("\\"); 錯誤：printf("\");
\'	39	0x27	' 單引號		打印一個‘'’	正確：printf("\'"); 錯誤：printf("'");
\"	34	0x22	" 雙引號		打印一個‘"’	正確：printf("\""); 錯誤：printf(""");
\0	0	0x0	NULL 空字符		字符串結束標記	printf("abc\0efg"); 輸出：abc
\xhh					對應一個十六進制ASCII碼值的字符	'\x0A' 至關於 '\n' '\x1B' 至關於 '\e' 正確：printf("\xA"); printf("\x00a"); 錯誤：printf("\x100"); printf("\x");
\bbb					對應一個八進制ASCII碼值的字符	'\101' 至關於 'A' '\033' 至關於 '\e' printf("\071"); 輸出：9 printf("\1013"); 輸出：A3 printf("\778"); 輸出：?8

\e	27	0x1B	Esc 退出	操做符	不支持
\e[0m					不支持
\e[1m					不支持
\e[4m					不支持
\e[5m					不支持
\e[7m					不支持
\e[8m					不支持
\e[30m					不支持
\e[31m					不支持
\e[32m					不支持
\e[33m					不支持
\e[34m					不支持
\e[35m					不支持
\e[36m					不支持
\e[37m					不支持
\e[40m					不支持
\e[41m					不支持
\e[42m					不支持
\e[43m					不支持
\e[44m					不支持
\e[45m					不支持
\e[46m					不支持
\e[47m					不支持
\e[nA					不支持
\e[nB					不支持
\e[nC					不支持
\e[nD					不支持
\e[y;xH					不支持
\e[2J					不支持
\e[K					不支持
\e[s					不支持
\e[u					不支持
\e[?25l					不支持
\e[?25h					不支持

7 常量類型

與變量相似，常量實際上也有多種細分的類型。在C語言中變量須要先定義類型才能在語句中使用，而常量有默認的類型。

數值末尾不添加類型說明符的整型常量默認爲是int型的。超出int型範圍的整型常量，默認爲是long型的。也就是說，整型常量1234必定是int類型的，而整型常量123467（超過了32767）在int型最大值是32767的系統中是long型的。

數值末尾不添加類型說明符的浮點型常量默認爲是double型的。也就是說，任意一個浮點型常量，不管是小數形式表示的，仍是指數形式表示的，只要數的末尾沒有加類型說明符F（或者f）,一概被編譯程序當成是double型的常量。

若是默認的類型不合適，能夠在常量的末尾加上類型說明符。

對於整型常量，可在末尾加U表示無符號整型或加L表示長整型；在整型常量的開頭，還可加上進制說明符，以0開頭表示八進制整數，0x或0X開頭表示十六進制整數。

對浮點型常量，在末尾可加F（或f），表示該常量是單精度浮點型。

（1）數值常量的存儲類型（初學時沒必要看）

與基本類型變量同樣，常量也分爲三大類型：字符型、整型和浮點型。除了字符型常量比較簡單外，常量根據在內存中存儲方式（參見本章提升部分）的不一樣，可細分爲不少類型。全部常量的（不一樣存儲）類型請參見表3-2：

說明：說明常量類型的字符U、L、F均可以用小寫字符u、l、f，多個類型符號連在一塊兒書寫時，符號之間的順序是任意的。好比，123UL、 123LU、123ul都是同樣的。

總之，數值末尾不添加類型說明符的整型常量（好比123）默認是int型的，可是該數的值若是超出了int型的範圍，那麼該數默認是long型的；不添加類型說明符的實型常量（好比123.34）必定是double型的。

其餘強制指定的常量類型通常不多使用。強制指定常量類型經常是爲了減小程序運行時的類型轉換。好比在變量定義時，使用「float x = 123.3F;」就比使用「floatx=123.3 ;」要好，前者避免了一次沒必要要的運行時的類型轉換。

（2）數值常量的多種機外書寫形式（初學時沒必要看）

上表中對常量的分類，是一種本質上的分類，由於上表中各類不一樣的常量在內存中的存儲方式不一樣（參見本章提升部分）。可是，常量還能夠根據在源程序中的書寫（或輸入輸出中的）形式來進行分類。

上一章已經講過，浮點型常量有兩種書寫形式：十進制小數形式和十進制指數形式。如，小數形式123.45和指數形式1.2345e2，在內存中實際上是具備徹底相同存儲形式的浮點數（默認爲double型的）。它們僅僅是在程序中（或輸入輸出時）的表現形式不一樣而已。再加上不一樣的存儲形式（double型與float型），數值大小相同（取值不超過float型範圍）的浮點型常量一共有4種機外表示形式：123.4五、1.2345e二、123.45f、1.2345e2f。

整型常量在C語言源程序中（或程序運行的輸入輸出時），除了能夠用十進制形式書寫（或輸入輸出）以外，還能夠使用八進制和十六進制形式來書寫（或輸入輸出）。

八進制整型常量：常量中只包含數字0～7，用0開頭表示的數都是八進制整型常量。好比，03四、06五、–013。

十六進制整型常量：常量中包含數字0～9和字符a～f（或者用A～F），以0x（或0X）開頭的，都是十六進制整型常量。好比，0x3d、 0XEF、–0x8a等。

同一個十進制整數123（默認爲int型），還能夠用八進制整數0173來表示，或者用十六進制整數0x7B來表示。它們也僅僅是在程序中（或輸入輸出時）的表現形式不一樣而已，在計算機內部，它們是形式徹底相同的二進制整數0000000001111011（假設int型佔2個字節）。再加上不一樣的存儲形式（int、long、unsigned、unsigned long），數值大小相同且值不超過int範圍的整型常量一共有3×4=12種機外表示形式：12三、123L、123U、123UL、017三、0173L、0173U、0173UL、0x7B、0x7BL、0x7BU、0x7BUL。

八進制和十六進制整數主要應用在系統編程和嵌入式編程方面（主要緣由在於：機外形式的八進制和十六進制整數與機內形式的二進制整數之間很容易進行相互轉換）。若是一個二進制整數中的n個位分別用來表示n個開關的狀態，在用C語言編程時，那麼就最好使用無符號的八進制整數（或無符號十六進制的整數）來表示此二進制整數，C語言的源程序中沒法直接使用二進制整數。

8 ASCII碼字符表

二進制	八進制	十進制	十六進制	對應按鍵	縮寫/字符	解釋
0000 0000	000	0	00		NUL (null)	空字符
0000 0001	001	1	01		SOH (start of headline)	標題開始
0000 0010	002	2	02		STX (start of text)	正文開始
0000 0011	003	3	03		ETX (end of text)	正文結束
0000 0100	004	4	04		EOT (end of transmission)	傳輸結束
0000 0101	005	5	05		ENQ (enquiry)	請求
0000 0110	006	6	06		ACK (acknowledge)	收到通知
0000 0111	007	7	07		BEL (bell)	響鈴
0000 1000	010	8	08		BS (backspace)	退格
0000 1001	011	9	09	Tab製表	HT (horizontal tab)	水平製表符
0000 1010	012	10	0A	Enter回車	LF (NL line feed, new line)	換行鍵
0000 1011	013	11	0B		VT (vertical tab)	垂直製表符
0000 1100	014	12	0C		FF (NP form feed, new page)	換頁鍵
0000 1101	015	13	0D		CR (carriage return)	回車鍵
0000 1110	016	14	0E		SO (shift out)	不用切換
0000 1111	017	15	0F		SI (shift in)	啓用切換
0001 0000	020	16	10		DLE (data link escape)	數據鏈路轉義
0001 0001	021	17	11		DC1 (device control 1)	設備控制1
0001 0010	022	18	12		DC2 (device control 2)	設備控制2
0001 0011	023	19	13		DC3 (device control 3)	設備控制3
0001 0100	024	20	14		DC4 (device control 4)	設備控制4
0001 0101	025	21	15		NAK (negative acknowledge)	拒絕接收
0001 0110	026	22	16		SYN (synchronous idle)	同步空閒
0001 0111	027	23	17		ETB (end of trans. block)	傳輸塊結束
0001 1000	030	24	18		CAN (cancel)	取消
0001 1001	031	25	19		EM (end of medium)	介質中斷
0001 1010	032	26	1A		SUB (substitute)	替補
0001 1011	033	27	1B		ESC (escape)	換碼(溢出)
0001 1100	034	28	1C		FS (file separator)	文件分割符
0001 1101	035	29	1D		GS (group separator)	分組符
0001 1110	036	30	1E		RS (record separator)	記錄分離符
0001 1111	037	31	1F		US (unit separator)	單元分隔符
0010 0000	040	32	20	Space空格	(space)	空格
0010 0001	041	33	21		!
0010 0010	042	34	22		"
0010 0011	043	35	23		#
0010 0100	044	36	24		$
0010 0101	045	37	25		%
0010 0110	046	38	26		&
0010 0111	047	39	27		'
0010 1000	050	40	28		(
0010 1001	051	41	29		)
0010 1010	052	42	2A		*
0010 1011	053	43	2B		+
0010 1100	054	44	2C		,
0010 1101	055	45	2D		-
0010 1110	056	46	2E		.
0010 1111	057	47	2F		/
0011 0000	060	48	30		0
0011 0001	061	49	31		1
0011 0010	062	50	32		2
0011 0011	063	51	33		3
0011 0100	064	52	34		4
0011 0101	065	53	35		5
0011 0110	066	54	36		6
0011 0111	067	55	37		7
0011 1000	070	56	38		8
0011 1001	071	57	39		9
0011 1010	072	58	3A		:
0011 1011	073	59	3B		;
0011 1100	074	60	3C		<
0011 1101	075	61	3D		=
0011 1110	076	62	3E		>
0011 1111	077	63	3F		?
0100 0000	100	64	40		@
0100 0001	101	65	41		A
0100 0010	102	66	42		B
0100 0011	103	67	43		C
0100 0100	104	68	44		D
0100 0101	105	69	45		E
0100 0110	106	70	46		F
0100 0111	107	71	47		G
0100 1000	110	72	48		H
0100 1001	111	73	49		I
0100 1010	112	74	4A		J
0100 1011	113	75	4B		K
0100 1100	114	76	4C		L
0100 1101	115	77	4D		M
0100 1110	116	78	4E		N
0100 1111	117	79	4F		O
0101 0000	120	80	50		P
0101 0001	121	81	51		Q
0101 0010	122	82	52		R
0101 0011	123	83	53		S
0101 0100	124	84	54		T
0101 0101	125	85	55		U
0101 0110	126	86	56		V
0101 0111	127	87	57		W
0101 1000	130	88	58		X
0101 1001	131	89	59		Y
0101 1010	132	90	5A		Z
0101 1011	133	91	5B		[
0101 1100	134	92	5C		\
0101 1101	135	93	5D		]
0101 1110	136	94	5E		^
0101 1111	137	95	5F		_
0110 0000	140	96	60		`
0110 0001	141	97	61		a
0110 0010	142	98	62		b
0110 0011	143	99	63		c
0110 0100	144	100	64		d
0110 0101	145	101	65		e
0110 0110	146	102	66		f
0110 0111	147	103	67		g
0110 1000	150	104	68		h
0110 1001	151	105	69		i
0110 1010	152	106	6A		j
0110 1011	153	107	6B		k
0110 1100	154	108	6C		l
0110 1101	155	109	6D		m
0110 1110	156	110	6E		n
0110 1111	157	111	6F		o
0111 0000	160	112	70		p
0111 0001	161	113	71		q
0111 0010	162	114	72		r
0111 0011	163	115	73		s
0111 0100	164	116	74		t
0111 0101	165	117	75		u
0111 0110	166	118	76		v
0111 0111	167	119	77		w
0111 1000	170	120	78		x
0111 1001	171	121	79		y
0111 1010	172	122	7A		z
0111 1011	173	123	7B		{
0111 1100	174	124	7C		\|
0111 1101	175	125	7D		}
0111 1110	176	126	7E		~
0111 1111	177	127	7F		DEL (delete)	刪除

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。