WS_GET_CHANNEL_PROPERTY_CALLBACK 콜백 함수(webservices.h)

  • 아티클

WS_CUSTOM_CHANNEL_BINDING 대한 WsGetChannelProperty 호출을 처리합니다.

구문

WS_GET_CHANNEL_PROPERTY_CALLBACK WsGetChannelPropertyCallback;

HRESULT WsGetChannelPropertyCallback(
  [in]           void *channelInstance,
  [in]           WS_CHANNEL_PROPERTY_ID id,
                 void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

매개 변수

[in] channelInstance

이 채널과 관련된 상태에 대한 포인터는 WS_CREATE_CHANNEL_CALLBACK 만든 대로 instance.

[in] id

검색할 속성의 ID입니다.

value

검색된 속성을 저장할 위치입니다. 포인터는 속성 형식과 호환되는 맞춤이 있어야 합니다.

[in] valueSize

검색된 속성을 저장하기 위해 호출자가 할당한 바이트 수입니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

반환 코드 설명
E_INVALIDARG
 이 개체에 대해 속성 ID가 지원되지 않았거나 지정된 버퍼가 값에 충분히 크지 않았습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

이 API의 계약에 대한 자세한 내용은 WsGetChannelProperty 를 참조하세요.

모든 사용자 지정 채널 구현은 적어도 다음 속성에 대한 값 반환을 지원해야 합니다.

서비스 모델 계층은 기본 채널에서 시간 제한을 사용하지 않도록 설정해야 하므로 고유한 호출 시간 제한 논리를 제공합니다. 서비스 모델 계층에서 사용자 지정 채널을 사용하려면 모든 시간 제한을 사용하지 않도록 지원하고 WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS 대한 이 콜백을 구현해야 합니다. WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS 대한 쿼리가 FALSE를 반환하지 않는 한 서비스 모델을 통해 사용자 지정 채널을 사용할 수 없습니다.

지원하려는 추가 속성을 결정하는 것은 사용자 지정 채널 구현에 달려 있습니다.

속성이 지원되지 않으면 E_INVALIDARG 반환되어야 합니다. ( Windows Web Services 반환 값을 참조하세요.)

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 webservices.h