Fungsi RasAdminGetErrorString

Artikel
06/13/2023

[Fungsi ini disediakan hanya untuk kompatibilitas mundur dengan Windows NT Server 4.0. Ini mengembalikan ERROR_CALL_NOT_IMPLEMENTED pada Windows Server 2003. Aplikasi harus menggunakan fungsi MprAdminGetErrorString .]

Fungsi RasAdminGetErrorString mengambil string pesan yang sesuai dengan kode kesalahan RAS yang dikembalikan oleh salah satu fungsi administrasi server RAS (RasAdmin). String pesan ini diambil dari Rasmsg.dll yang diinstal sebagai bagian dari RAS.

Sintaks

DWORD RasAdminGetErrorString(
  _In_  UINT  ResourceId,
  _Out_ WCHAR *lpszString,
  _In_  DWORD InBufSize
);

Parameter

ResourceId [in]: Menentukan kode kesalahan yang dikembalikan oleh salah satu fungsi RasAdmin. Nilai ini harus dalam rentang kode kesalahan dari RASBASE ke RASBASEEND. Ini didefinisikan dalam Raserror.h.
lpszString [out]: Penunjuk ke buffer yang menerima pesan kesalahan yang sesuai dengan kode kesalahan yang ditentukan.
InBufSize [in]: Menentukan ukuran, dalam karakter, dari buffer lpszString . Pesan kesalahan biasanya 80 karakter atau kurang; ukuran buffer 512 karakter selalu memadai.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan. Nilai ini dapat menjadi nilai kesalahan terakhir yang ditetapkan oleh fungsi LoadLibrary, GlobalAlloc, atau LoadString ; atau bisa menjadi salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter ResourceId atau lpszString tidak valid.
ERROR_INSUFFICIENT_BUFFER	Ukuran yang ditentukan oleh parameter InBufSize terlalu kecil.

Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.

Keterangan

Fungsi RasAdmin dapat mengembalikan kode kesalahan yang tidak berada dalam rentang yang didukung oleh fungsi RasAdminGetErrorString . Misalnya, fungsi RasAdmin dapat mengembalikan kode kesalahan yang ditentukan dalam Lmerr.h dan Winerror.h. Sebelum memanggil RasAdminGetErrorString, verifikasi bahwa kode kesalahan berada dalam rentang RASBASE ke RASBASEEND, seperti yang didefinisikan dalam Raserror.h.

Persyaratan

Persyaratan	Nilai
Akhir dukungan klien	Windows 2000 Professional
Akhir dukungan server	Windows 2000 Server
Header	Rassapi.h
Pustaka	Rassapi.lib
DLL	Rassapi.dll

Lihat juga

Gambaran Umum Layanan Akses Jarak Jauh (RAS)
Fungsi Administrasi Server RAS
LoadLibrary
GlobalAlloc
LoadString