WS_VALIDATE_PASSWORD_CALLBACK 콜백 함수(webservices.h)

수신자 쪽에서 사용자 이름/암호 쌍의 유효성을 검사합니다. 이 콜백을 포함하는 WS_USERNAME_MESSAGE_SECURITY_BINDING 보안 설명에 포함되면 이 콜백은 서버에서 받은 각 메시지에 대해 호출됩니다. 이 콜백은 쌍의 유효성을 검사할 수 없는 경우와 예기치 않은 오류가 발생한 경우 오류 값을 S_FALSE 사용자 이름/암호 쌍의 유효성을 성공적으로 검사한 S_OKif 반환해야 합니다. 이 콜백에서 S_OK 이외의 결과를 반환하면 연결된 수신 메시지가 보안 오류와 함께 실패합니다.

모든 보안 콜백과 마찬가지로 애플리케이션은 채널/수신기가 열리고 닫히면 언제든지 이 콜백을 수신해야 하지만 채널이 열리지 않으면 호출되지 않습니다. 현재 드롭에서 이 콜백은 항상 동기적으로 호출됩니다. 다음 드롭에서 이 콜백은 동기 메시지 수신에 대해 동기적으로 호출되고 비동기 메시지 수신에 대해 비동기적으로 호출되지만 비동기적으로 호출될 때는 항상 짧게 호출됩니다.

구문

WS_VALIDATE_PASSWORD_CALLBACK WsValidatePasswordCallback;

HRESULT WsValidatePasswordCallback(
  [in, optional] void *passwordValidatorCallbackState,
  [in]           const WS_STRING *username,
  [in]           const WS_STRING *password,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

매개 변수

[in, optional] passwordValidatorCallbackState

이 콜백을 호출할 때 다시 전달될 상태입니다.

[in] username

받은 사용자 이름입니다.

[in] password

받은 암호입니다.

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법 또는 동기적으로 호출하는 경우 NULL 에 대한 정보입니다.

[in, optional] error

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

반환 값

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

요구 사항

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