IExternalConnection::AddConnection 메서드(objidl.h)

개체의 강력한 외부 연결 수를 증분합니다.

구문

DWORD AddConnection(
  [in] DWORD extconn,
  [in] DWORD reserved
);

매개 변수

[in] extconn

개체에 대한 외부 연결의 형식입니다. 현재 이 인터페이스에서 지원되는 유일한 외부 연결 형식은 강력하므로 이 외부 연결이 있는 한 개체가 활성 상태로 유지되어야 합니다. 강력한 외부 연결은 열거 형 EXTCONN에 정의된 EXTCONN_STRONG 값으로 표시됩니다.

[in] reserved

연결에 대한 정보입니다. 이 매개 변수는 OLE에서 사용하도록 예약되어 있습니다. 해당 값은 0일 수 있지만 반드시 그렇지는 않습니다. 따라서 AddConnection 의 구현에는 0 값이 반환되는지 여부에 따라 실행되는 코드 블록이 포함되어서는 안 됩니다.

반환 값

메서드는 연결 수를 반환합니다. 이 값은 디버깅 목적으로만 사용됩니다.

설명

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 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	objidl.h(ObjIdl.h 포함)

추가 정보

IExternalConnection

IRunnableObject::LockRunning

OleLockRunning