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