Fungsi MprAdminInterfaceGetCredentials (mprapi.h)

Gunakan fungsi MprAdminInterfaceGetCredentials untuk mengambil domain, nama pengguna, dan kata sandi untuk melakukan panggilan keluar pada antarmuka putar nomor permintaan yang ditentukan.

Sintaks

DWORD MprAdminInterfaceGetCredentials(
  [in]  LPWSTR lpwsServer,
  [in]  LPWSTR lpwsInterfaceName,
  [out] LPWSTR lpwsUserName,
  [out] LPWSTR lpwsPassword,
  [out] LPWSTR lpwsDomainName
);

Parameter

[in] lpwsServer

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama perute untuk menjalankan panggilan ini.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, panggilan dijalankan pada komputer lokal.

[in] lpwsInterfaceName

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama antarmuka putar-nomor permintaan. Gunakan MprAdminInterfaceGetInfo untuk mendapatkan nama antarmuka.

[out] lpwsUserName

Penunjuk ke string Unicode yang menerima nama pengguna. String ini harus panjangNYA UNLEN+1.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengembalikan nama pengguna.

[out] lpwsPassword

Penunjuk ke string Unicode yang menerima kata sandi. String ini harus panjang PWLEN+1.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengembalikan kata sandi.

[out] lpwsDomainName

Penunjuk ke string Unicode yang menerima nama domain. String ini harus panjang DNLEN+1.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengembalikan nama domain.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Antarmuka yang ditentukan tidak memiliki parameter putar nomor permintaan yang terkait dengannya.
ERROR_INVALID_PARAMETER	Parameter lpwsInterfaceName adalah NULL.
NO_ERROR	Parameter lpwsUserName, lpwsPassword, dan lpwsDomainName semuanya NULL.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Parameter lpwsUserName, lpwsPassword, dan lpwsDomainName bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk ketiga parameter, MprAdminInterfaceGetCredentials mengembalikan NO_ERROR dan domain, nama pengguna, dan kata sandi tidak dikembalikan.

Konstanta UNLEN, PWLEN, dan DNLEN adalah panjang maksimum untuk nama pengguna, kata sandi, dan nama domain. Konstanta ini didefinisikan dalam lmcons.h.

Perhatikan bahwa urutan parameter di MprAdminInterfaceGetCredentials berbeda dari MprAdminInterfaceSetCredentials.

Persyaratan

Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mprapi.h
Pustaka	Mprapi.lib
DLL	Mprapi.dll

Lihat juga

FormatMessage

MprAdminInterfaceSetCredentials

Fungsi Administrasi Perute

Referensi Manajemen Router