EapHostPeerSetResponseAttributes 函式 (eappapis.h)

提供 EAPHost 的已更新 EAP 驗證屬性。

語法

DWORD EapHostPeerSetResponseAttributes(
  [in]  EAP_SESSIONID               sessionHandle,
  [in]  const EapAttributes * const pAttribs,
  [out] EapHostPeerResponseAction   *pEapOutput,
  [out] EAP_ERROR                   **ppEapError
);

參數

[in] sessionHandle

EAP_SESSIONID結構的指標，其中包含 EAPHost 伺服器上這個 EAP 驗證會話的唯一控制碼。 這個控制碼會在先前呼叫EapHostPeerBeginSession的pSessionId參數中傳回。

[in] pAttribs

EapAttributes結構的指標，其中包含要為 EAPHost 上支援者設定的新 EAP 驗證回應屬性陣列。

[out] pEapOutput

EapHostPeerResponseAction列舉值的指標，指定下一個步驟的動作程式碼，要求者必須做為回應。

[out] ppEapError

EAP_ERROR結構的位址指標。 在呼叫此函式之前，位址應該設定為 Null 。 如果有錯誤資料可用，就會收到包含此函式呼叫執行期間所引發之 錯誤之EAP_ERROR 結構的位址指標。 使用錯誤資料之後，請呼叫 EapHostPeerFreeEapError釋放此記憶體。

傳回值

無

備註

若要在呼叫 EapHostPeerGetResponseAttributes之後繼續進行狀態機器的下一個步驟，要求者必須呼叫 EapHostPeerSetResponseAttributes。 成功者必須這麼做才能傳遞有效的 EapAttributes 結構，即使成功者無法使用 EapHostPeerGetResponseAttributes傳回的屬性也一樣。

下列範例顯示 EapHostPeerSetResponseAttributes 呼叫，該呼叫只會進展到狀態機器中的下一個狀態。

EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);

// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};

// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);

需求

另請參閱

EAPHost Supplicant 執行時間函式

EapHostPeerGetResponseAttributes