ITsSbClientConnection::P utContext 메서드(sbtsv.h)

플러그 인에서 연결과 관련된 컨텍스트 정보를 저장하는 데 사용할 수 있습니다.

구문

HRESULT PutContext(
  [in]            BSTR    contextId,
  [in]            VARIANT context,
  [out, optional] VARIANT *existingContext
);

매개 변수

[in] contextId

컨텍스트 ID를 포함하는 BSTR 변수입니다. 플러그 인 간의 충돌을 방지하려면 고유 식별자를 컨텍스트 ID로 사용하는 것이 좋습니다. 클라이언트 연결 개체는 둘 이상의 플러그 인에서 사용할 수 있습니다.

[in] context

저장할 컨텍스트 정보입니다.

[out, optional] existingContext

제공된 컨텍스트 ID에 대한 기존 컨텍스트 정보(있는 경우)가 이 매개 변수에 반환됩니다. 기존 정보를 덮어씁니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

플러그 인은 클라이언트 연결 개체를 사용하여 연결 요청과 관련된 컨텍스트 정보를 저장할 수 있습니다. 이렇게 하면 플러그 인이 상태 비주류 상태로 유지되고 연결 요청에 의해 저장된 상태 정보에만 의존할 수 있습니다. 이 메서드를 사용하는 플러그 인은 연결 요청 알림을 등록할 수도 있습니다. CONNECTION_REQUEST_FAILED, CONNECTION_REQUEST_TIMEDOUT 또는 CONNECTION_REQUEST_SUCCEEDED 알림을 받으면 컨텍스트를 삭제할 수 있습니다. 이러한 알림은 연결 요청이 삭제될 예정임을 나타냅니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	sbtsv.h

추가 정보

ITsSbClientConnection