RasGetEapUserDataA 函式 (ras.h)
使用 RasGetEapUserData 函式,擷取指定電話簿項目的使用者特定可延伸驗證通訊協定 (EAP) 資訊。
語法
DWORD RasGetEapUserDataA(
[in] HANDLE hToken,
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[out] BYTE *pbEapData,
[in, out] DWORD *pdwSizeofEapData
);
參數
[in] hToken
處理代表要擷取數據之使用者的主要或模擬存取令牌。 如果函式是從已在使用者內容中執行的進程呼叫,則可以 NULL。
[in] pszPhonebook
Null 終止字串的指標,指定電話簿檔案的完整路徑。 如果此參數 NULL,則函式會使用系統電話簿。
[in] pszEntry
指定現有項目名稱之 Null 終止字串的指標。
[out] pbEapData
接收使用者所擷取 EAP 數據的緩衝區指標。 呼叫端應該配置這個緩衝區的記憶體。 如果緩衝區不夠大,RasGetEapUserData 會傳回 ERROR_BUFFER_TOO_SMALL,而 pdwSizeofEapData 參數包含所需的大小。
[in, out] pdwSizeofEapData
DWORD 變數的指標,該變數在輸入時會指定 pbEapData 參數所指向的緩衝區大小。
如果 pbEapData 參數所指定的緩衝區不夠大,pdwSizeofEapData 會在輸出時收到所需的大小。
傳回值
如果函式成功,則傳回值會 ERROR_SUCCESS。
如果函式失敗,傳回值是下列其中一個錯誤碼,或來自 路由和遠端訪問錯誤碼的值 或 Winerror.h。
價值 | 意義 |
---|---|
|
pdwSizeofEapData 參數 NULL。 |
|
pbEapData 所指向的緩衝區 太小,無法接收數據。 pdwSizeofEapData 包含所需的大小。 |
|
RasGetEapUserData 無法開啟指定的電話簿檔案。 |
|
RasGetEapUserData 找不到電話簿中指定的專案。 |
|
使用 FormatMessage 擷取對應至傳回錯誤碼的系統錯誤訊息。 |
言論
注意
ras.h 標頭會根據 UNICODE 預處理器常數的定義,將 RasGetEapUserData 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | ras.h |
連結庫 | Rasapi32.lib |
DLL | Rasapi32.dll |