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)

另請參閱

IExternalConnection

IRunnableObject::LockRunning

OleLockRunning