IExternalConnection::AddConnection 方法 (objidl.h)
遞增對象的強外部連接計數。
語法
DWORD AddConnection(
[in] DWORD extconn,
[in] DWORD reserved
);
參數
[in] extconn
物件的外部連接類型。 此介面目前唯一支援的外部連接類型是強式的,這表示只要此外部連接存在,對象就必須保持運作。 強外部連線是由列舉 EXTCONN 中所定義的值EXTCONN_STRONG來表示。
[in] reserved
線上的相關信息。 此參數保留供 OLE 使用。 其值可以是零,但不一定。 因此, AddConnection 的實作不應包含執行取決於是否傳回零值的程式代碼區塊。
傳回值
方法會傳回連線計數。 此值僅供偵錯之用。
備註
EXE 物件伺服器所建立的物件會依賴其存根管理員,在連結客戶端啟動時呼叫 AddConnection ,因此會在物件上建立外部鎖定。 當鏈接用戶端中斷連線時,存根管理員會呼叫 IExternalConnection::ReleaseConnection 來釋放鎖定。
DLL 物件應用程式存在於與其物件相同的進程空間中,因此不會使用 RPC (遠端過程調用) ,而且沒有存根管理員來追蹤外部連線。 因此,支援其物件外部連結的 DLL 伺服器必須實作 IExternalConnection ,讓連結用戶端可以直接呼叫介面,以在新增或釋放連線時通知它們。
以下是 AddConnection 方法的一般實作。
DWORD MyInterface::AddConnection(DWORD extconn, DWORD dwReserved)
{
return extconn & EXTCONN_STRONG ? ++m_cStrong : 0;
}
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | objidl.h (包含 ObjIdl.h) |