Fungsi NetAccessEnum (lmaccess.h)

Artikel
02/28/2024

[Fungsi ini sudah usang. Untuk daftar fungsi alternatif, lihat Fungsi Otorisasi.]

Tidak didukung.

Fungsi NetAccessEnum mengambil informasi tentang setiap rekaman izin akses.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

Parameter

servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

BasePath

Penunjuk ke string yang berisi nama jalur dasar untuk sumber daya. Pointer NULL atau string NULL berarti tidak ada jalur dasar yang akan digunakan. Jalur dapat ditentukan sebagai nama jalur konvensi penamaan universal (UNC).

Recursive

Menentukan bendera yang mengaktifkan atau menonaktifkan pencarian rekursif.

Jika parameter ini sama dengan nol, fungsi NetAccessEnum mengembalikan entri untuk sumber daya yang dinamai sebagai jalur dasar oleh parameter pszBasePath , dan untuk sumber daya tepat di bawah jalur dasar tersebut.

Jika parameter ini bukan nol, fungsi mengembalikan entri untuk semua daftar kontrol akses (ACL) yang memiliki pszBasePath di awal nama sumber daya.

level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Parameter pbBuffer menunjuk ke struktur access_info_0 .
1	Parameter pbBuffer menunjuk ke struktur access_info_1 .

bufptr

Arahkan ke buffer yang menerima struktur informasi akses. Format data ini tergantung pada nilai parameter sLevel .

prefmaxlen

Menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter pbBuffer .

entriesread

Penunjuk ke bilangan bulat pendek yang tidak ditandatangani yang menerima jumlah elemen yang benar-benar dijumlahkan. Hitungan hanya valid jika fungsi NetAccessEnum mengembalikan NERR_Success atau ERROR_MORE_DATA.

totalentries

Penunjuk ke bilangan bulat pendek yang tidak ditandatangani yang menerima jumlah total entri yang bisa saja dijumlahkan. Hitungan hanya valid jika fungsi NetAccessEnum mengembalikan NERR_Success atau ERROR_MORE_DATA.

resume_handle

TBD

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Fungsi ini memerlukan hak istimewa Admin untuk berhasil dijalankan pada komputer yang mengaktifkan keamanan lokal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmaccess.h (termasuk Lm.h, Lmaccess.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

Fungsi otorisasi

Bagikan melalui