WS_GET_CERT_CALLBACK 콜백 함수(webservices.h)

보안 런타임에 인증서를 제공합니다. 이 콜백은 WS_CUSTOM_CERT_CREDENTIAL 일부로 지정되며, 인증서 자격 증명이 필요한 보안 바인딩의 일부로 지정할 수 있습니다. 런타임은 채널(클라이언트 쪽) 또는 수신기(서버 쪽)가 열릴 때 이 콜백을 호출합니다.

인증서 소유권: 이 콜백이 성공 HRESULT를 반환하는 경우 호출자(즉, 보안 런타임)는 반환된 인증서의 소유권을 가지며 포함된 채널에 더 이상 필요하지 않을 때 해제됩니다. 이 콜백이 실패 HRESULT를 반환하는 경우 호출자는 out 매개 변수 'cert'에 반환된 값의 소유권을 가져오거나 보지 않습니다.

구문

WS_GET_CERT_CALLBACK WsGetCertCallback;

HRESULT WsGetCertCallback(
  [in]           void *getCertCallbackState,
  [in, optional] const WS_ENDPOINT_ADDRESS *targetAddress,
  [in, optional] const WS_STRING *viaUri,
                 const _CERT_CONTEXT **cert,
  [in, optional] WS_ERROR *error
)
{...}

매개 변수

[in] getCertCallbackState

인증서 자격 증명에서 이 콜백과 함께 지정된 상태입니다.

[in, optional] targetAddress

이 인증서 자격 증명이 클라이언트에 대해 지정된 경우 이 인증서를 표시할 대상 주소입니다.

[in, optional] viaUri

이 인증서를 제시할 주소를 통해 입니다.

cert

인증서를 반환할 위치입니다.

[in, optional] error

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

반환 값

이 콜백 함수는 값을 반환하지 않습니다.

요구 사항

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