RasAdminGetErrorString 函式
[此函式僅適用于與 server 4.0 Windows NT的回溯相容性。 它會在 Windows Server 2003 上傳回ERROR_CALL_NOT_IMPLEMENTED。 應用程式應該使用 MprAdminGetErrorString 函式 。]
RasAdminGetErrorString函式會擷取對應至 RAS 伺服器管理 (RasAdmin) 函式所傳回的 RAS 錯誤碼的訊息字串。 這些訊息字串是從作為 RAS 一部分安裝的Rasmsg.dll擷取。
語法
DWORD RasAdminGetErrorString(
_In_ UINT ResourceId,
_Out_ WCHAR *lpszString,
_In_ DWORD InBufSize
);
參數
-
ResourceId [in]
-
指定其中一個 RasAdmin 函式傳回的錯誤碼。 此值必須位於從 RASBASE 到 RASBASEEND 的錯誤碼範圍內。 這些定義于 Raserror.h 中。
-
lpszString [out]
-
緩衝區的指標，接收對應至指定錯誤碼的錯誤訊息。
-
InBufSize [in]
-
指定 lpszString 緩衝區的大小，以字元為單位。 錯誤訊息通常是 80 個字元或更少;緩衝區大小一律為 512 個字元。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，則傳回值是錯誤碼。 此值可以是 LoadLibrary、 GlobalAlloc或 LoadString 函式所設定的最後一個錯誤值;或可以是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
ResourceId或lpszString參數無效。 |
|
InBufSize參數所指定的大小太小。 |
此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。
備註
RasAdmin 函式可以傳回不在 RasAdminGetErrorString 函式所支援範圍內的錯誤碼。 例如，RasAdmin 函式可以傳回 Lmerr.h 和 Winerror.h 中定義的錯誤碼。 呼叫 RasAdminGetErrorString之前，請確認錯誤碼位於 RASBASE 到 RASBASEEND 的範圍內，如 Raserror.h 中所定義。
規格需求
| 需求 | 值 |
|---|---|
| 用戶端支援結束 |
Windows 2000 Professional |
| 伺服器終止支援 |
Windows 2000 Server |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|