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 中的值。
值 | 意義 |
---|---|
|
dwSizeofEapData 參數為零,或 pbEapData 參數為 NULL。 |
|
RasSetEapUserData 無法開啟指定的電話簿檔案。 |
|
RasSetEapUserData 在電話簿中找不到指定的專案。 |
|
使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。 |
備註
注意
ras.h 標頭會根據 UNICODE 預處理器常數的定義,將 RasSetEapUserData 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ras.h |
程式庫 | Rasapi32.lib |
Dll | Rasapi32.dll |