(webservices.h) WS_VALIDATE_SAML_CALLBACK回呼函式

  • 發行項

驗證 SAML 判斷提示。 如果收到的 SAML 判斷提示通過簽章驗證檢查，以確保 SAML 是由受信任的簽發者所發出，則會叫用此回呼，讓應用程式能夠對 SAML 判斷提示的 XML 形式執行其他驗證。 如果 SAML 判斷提示已成功驗證，則此回呼預期會傳回S_OK，S_FALSE無法驗證判斷提示時傳回，並在發生非預期的錯誤時傳回錯誤值。 從這個回呼傳回S_OK以外的任何結果，將會導致相關聯的接收訊息失敗，並出現安全性錯誤。

如同所有安全性回呼，應用程式應該會在接聽程式開啟和關閉之間隨時收到此回呼，但是當接聽程式未開啟時，永遠不會叫用此回呼。

語法

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

HRESULT WsValidateSamlCallback(
  [in, optional] void *samlValidatorCallbackState,
  [in]           WS_XML_BUFFER *samlAssertion,
  [in, optional] WS_ERROR *error
)
{...}

參數

[in, optional] samlValidatorCallbackState

叫用此回呼時要傳回的狀態。

[in] samlAssertion

已接收的 SAML 判斷提示，已通過成功簽章檢查。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

這個回呼函式不會傳回值。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 webservices.h