验证接收方端的用户名/密码对。 当包含此回调 的WS_USERNAME_MESSAGE_SECURITY_BINDING 包含在安全说明中时,将为服务器上收到的每条消息调用此回调。 此回调预期会在成功验证用户名/密码对S_OKif返回,S_FALSE无法验证该对时返回,如果发生意外错误,则返回错误值。 从此回调返回除S_OK以外的任何结果将导致关联的接收消息失败并出现安全错误。
与所有安全回调一样,应用程序应在通道/侦听器打开和关闭之间的任何时间接收此回调,但当通道未打开时,它永远不会被调用。 在当前删除中,此回调始终以同步方式调用。 在下一个删除中,对于同步消息接收,将同步调用此回调,对于异步消息接收,将异步调用此回调,但在以异步方式调用时,它将始终调用 short 。
语法
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 |