RasSetEapUserDataA 函式 (ras.h)

使用 RasSetEapUserData 函式，在登錄中儲存使用者特定的可延伸驗證通訊協定 (EAP) 資訊。

語法

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

參數

[in] hToken

處理代表要儲存數據之使用者的主要或模擬存取令牌。 如果從已在使用者內容中執行的進程呼叫函式，這個參數可以是 NULL 。

[in] pszPhonebook

Null 終止字串的指標，指定電話簿 (PBK) 檔案的完整路徑。 如果此參數為 NULL，函式會使用系統電話簿。

[in] pszEntry

指定現有項目名稱之 Null 終止字串的指標。

[in] pbEapData

要為使用者儲存的數據指標。

[in] dwSizeofEapData

指定 pbEapData 參數所指向的數據大小。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值是下列其中一個錯誤碼，或是 路由和遠端訪問錯誤碼 或 Winerror.h 中的值。

值	意義
E_INVALIDARG	dwSizeofEapData 參數為零，或 pbEapData 參數為 NULL。
ERROR_CANNOT_OPEN_PHONEBOOK	RasSetEapUserData 無法開啟指定的電話簿檔案。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData 在電話簿中找不到指定的專案。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

注意

ras.h 標頭會根據 UNICODE 預處理器常數的定義，將 RasSetEapUserData 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	ras.h
程式庫	Rasapi32.lib
Dll	Rasapi32.dll

另請參閱

RasGetEapUserData

RasInvokeEapUI

遠端訪問服務 (RAS) 概觀

遠端存取服務函式