RasConnectionNotificationA 函式 (ras.h)

RasConnectionNotification 函式會指定系統在建立或終止 RAS 連線時設定為訊號狀態的事件物件。

語法

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

[in] unnamedParam1

接收通知之 RAS 連線的句柄。這可以是 RasDial 或 RasEnumConnections 函式所傳回的句柄。如果此參數 INVALID_HANDLE_VALUE，則會針對本機用戶端上的所有 RAS 連線收到通知。

[in] unnamedParam2

指定事件物件的句柄。使用 CreateEvent 函式來建立事件物件。

[in] unnamedParam3

指定 RAS 事件，讓系統向 hEvent 參數指定的事件對象發出訊號。此參數是下列值的組合。

值	意義
RASCN_Connection	如果 hrasconn是INVALID_HANDLE_VALUE，則會在建立任何 RAS 連線時發出 hEvent 訊號。
RASCN_Disconnection	hEvent 會在終止 hrasconn 連線時發出訊號。如果 hrasconn 是多連結連線，則當所有子實體中斷連線時，事件就會發出訊號。如果 hrasconnINVALID_HANDLE_VALUE，當任何 RAS 連線終止時，就會發出事件訊號。
RASCN_BandwidthAdded	Windows NT：如果 hrasconn 是合併多重連結連線的句柄，當子連線時，hEvent 會發出訊號。
RASCN_BandwidthRemoved	Windows NT：如果 hrasconn 是合併多重連結連線的句柄，當子連線中斷時，hEvent 會發出訊號。

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值是路由和遠端訪問錯誤碼或 Winerror.h 的非零錯誤碼。

若要判斷事件物件何時發出訊號，請使用任何等候函式。

當事件發出訊號時，請使用其他 RAS 函式，例如 RasEnumConnections，以取得已建立或終止之 RAS 連線的詳細資訊。

注意

ras.h 標頭會根據 UNICODE 預處理器常數的定義，將 RasConnectionNotification 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。