WS_VALIDATE_PASSWORD_CALLBACK回呼函式 (webservices.h)

驗證接收端的用戶名稱/密碼組。 當包含此回呼 的WS_USERNAME_MESSAGE_SECURITY_BINDING 包含在安全性描述中時，會針對伺服器上每個收到的訊息叫用此回呼。 此回呼預期會傳回S_OKif已成功驗證使用者名稱/密碼組，S_FALSE當無法驗證配對時，如果發生非預期的錯誤，則傳回錯誤值。 從這個回呼傳回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