DWORD RasGetConnectStatus(
_In_ HRASCONN hrasconn,
_Inout_ LPRASCONNSTATUS lprasconnstatus
);
說明
該函數用於獲取指定遠程訪問連接的當前狀態。應用程序可以使用此函數來檢測一個異步的RasDial調用是否完成。
參數
hrasconn [in]
指定要獲取狀態的連接句柄。
lprasconnstatus [in, out]
指向用於接收連接狀態信息的RASCONNSTATUS結構。調用前將結構成員dwSize設置爲sizeof(RASCONNSTATUS)。
返回值
成功時返回ERROR_SUCCESS。
失敗時返回以下列表中的值之一或來自Routing and Remote Access Error Codes或Winerror.h中定義的錯誤碼。
值 |
含義 |
ERROR_NOT_ENOUGH_MEMORY |
無法分配足夠的內存來完成操作。 |
注意事項
該函數的返回值不一定與RASCONNSTATUS結構中的dwError相同。函數返回值指示在調用該函數期間是否有錯誤發生。而dwError指示阻礙連接建立的錯誤。
系統支持
客戶端最小支持 |
Windows 2000專業版 |
服務端最小支持 |
Windows 2000 Server |
Header |
Ras.h |
Library |
Rasapi32.lib |
DLL |
Rasapi32.dll |
Unicode和ANSI名稱 |
RasGetConnectStatusW(Unicode)和RasGetConnectStatusA(ANSI) |