共用方式為

RasGetCustomAuthDataA 函式 （ras.h）

  • 發行項

使用 RasGetCustomAuthData 函式來擷取連線特定的驗證資訊。 這項資訊不是特定使用者特有的。

語法

DWORD RasGetCustomAuthDataA(
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbCustomAuthData,
  [in, out] DWORD  *pdwSizeofCustomAuthData
);

參數

[in] pszPhonebook

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

[in] pszEntry

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

[out] pbCustomAuthData

接收驗證數據的緩衝區指標。 呼叫端應該配置這個緩衝區的記憶體。 如果緩衝區不夠大，RasGetCustomAuthData 會傳回ERROR_BUFFER_TOO_SMALL，而 pdwSizeofEapData 參數包含所需的大小。

[in, out] pdwSizeofCustomAuthData

DWORD 變數的指標，該變數在輸入時會指定 pbCustomAuthData 參數所指向的緩衝區大小。

如果 pbCustomAuthData 參數所指定的緩衝區不夠大，pdwSizeofEapData 會在輸出時接收所需的大小。

傳回值

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

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

價值 意義
E_INVALIDARG
 pdwSizeofCustomAuthData 參數 NULL。
ERROR_BUFFER_TOO_SMALL
 pbCustomAuthData 所指向的緩衝區 太小，無法接收數據。 pdwSizeofCustomAuthData 包含所需的大小。
ERROR_CANNOT_OPEN_PHONEBOOK

RasGetEapUserData 無法開啟指定的電話簿檔案。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasGetEapUserData 找不到電話簿中指定的專案。
其他
 使用 FormatMessage 擷取對應至傳回錯誤碼的系統錯誤訊息。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 ras.h
連結庫 Rasapi32.lib
DLL Rasapi32.dll

另請參閱

RasGetEapUserData

RasSetCustomAuthData