IMbnConnection::Connect 메서드(mbnapi.h)

데이터 연결을 설정합니다.

구문

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

매개 변수

[in] connectionMode

연결 모드를 지정하는 MBN_CONNECTION_MODE 값입니다.

[in] strProfile

프로필 지정자를 포함합니다.

[out] requestID

이 비동기 요청을 식별하기 위해 모바일 광대역 서비스에서 반환한 고유한 요청 ID에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

Connect 메서드는 디바이스에 대한 연결 컨텍스트를 활성화하는 데 사용됩니다. 모바일 광대역 서비스는 현재 최대 하나의 활성 컨텍스트를 지원합니다. 컨텍스트를 활성화하면 L2 연결도 설정됩니다. 마찬가지로 컨텍스트를 비활성화하면 모바일 네트워크에 대한 물리적 데이터 연결이 끊어집니다.

이 작업을 호출할 때 디바이스가 패킷 연결 상태가 아닌 경우 모바일 광대역 서비스는 디바이스에 연결 요청을 실행하기 전에 디바이스를 암시적으로 패킷 연결합니다. 패킷 서비스 상태가 변경되면 IMbnRegistrationEvents 인터페이스의 OnPacketServiceStateChange 메서드를 호출하여 애플리케이션에 알림을 받습니다.

connectionMode가 MBN_CONNECTION_MODE_PROFILE 설정된 경우 strProfile은 디바이스의 프로필 이름을 나타냅니다. MBN_CONNECTION_MODE_TMP_PROFILE 설정된 경우 strProfile은 프로필의 XML 표현을 나타냅니다. 호출 애플리케이션은 IMbnConnectionProfileManager 를 사용하여 디바이스에 저장된 연결 프로필 목록을 가져올 수 있습니다.

즉시 반환되는 비동기 작업입니다. 이 메서드가 성공적으로 반환되면 모바일 광대역 서비스는 작업이 완료되면 IMbnConnectionEvents의 OnConnectComplete 메서드를 호출합니다.

Windows 8 이상 버전의 Windows: Windows 스토어 앱은 MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode와 strProfile 매개 변수만 프로필의 XML 표현으로 설정된 Connect를 사용할 수 있습니다. 이는 연결이 일시적인 특성이며 나중에 시스템에서 사용할 수 있도록 저장되지 않음을 의미합니다.

요구 사항

참고 항목

IMbnConnection