Bagikan melalui


Fungsi NetEnumerateComputerNames (lmjoin.h)

Fungsi NetEnumerateComputerNames menghitung nama untuk komputer yang ditentukan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
  [in, optional] LPCWSTR                Server,
  [in]           NET_COMPUTER_NAME_TYPE NameType,
  [in]           ULONG                  Reserved,
  [out]          PDWORD                 EntryCount,
  [out]          LPWSTR                 **ComputerNames
);

Parameter

[in, optional] Server

Penunjuk ke string konstanta yang menentukan nama komputer untuk menjalankan fungsi ini. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] NameType

Jenis nama yang dikueri. Anggota ini dapat menjadi salah satu nilai berikut yang ditentukan dalam enumerasi NET_COMPUTER_NAME_TYPE yang ditentukan dalam file header Lmjoin.h .

Nilai Makna
NetPrimaryComputerName
Nama komputer utama.
NetAlternateComputerNames
Nama komputer alternatif.
NetAllComputerNames
Semua nama komputer.
NetComputerNameTypeMax
Menunjukkan akhir rentang yang menentukan nilai yang mungkin untuk jenis nama yang akan dikueri.

[in] Reserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

[out] EntryCount

Penunjuk ke nilai DWORD yang mengembalikan jumlah nama yang dikembalikan dalam buffer yang ditujukkan oleh parameter ComputerNames jika fungsi berhasil.

[out] ComputerNames

Penunjuk ke array pointer ke nama. Jika panggilan fungsi berhasil, parameter ini akan mengembalikan nama komputer yang cocok dengan nama jenis komputer yang ditentukan dalam parameter NameType .

Ketika aplikasi tidak lagi membutuhkan array ini, buffer ini harus dibebaskan dengan memanggil fungsi NetApiBufferFree .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut atau salah satu kode kesalahan sistem.

Menampilkan kode Deskripsi
ERROR_ACCESS_DENIED
Akses ditolak. Kesalahan ini dikembalikan jika penelepon bukan anggota grup lokal Administrator pada komputer target.
ERROR_INVALID_PARAMETER
Parameter salah.
ERROR_NOT_ENOUGH_MEMORY
Tidak tersedia cukup memori untuk memproses perintah ini.
ERROR_NOT_SUPPORTED
Permintaan tidak didukung. Kesalahan ini dikembalikan jika komputer target yang ditentukan dalam parameter Server tempat fungsi ini dijalankan berjalan pada Windows 2000 dan yang lebih lama.
NERR_WkstaNotStarted
Layanan Stasiun Kerja belum dimulai.
RPC_S_CALL_IN_PROGRESS
Panggilan prosedur jarak jauh sudah berlangsung untuk utas ini.
RPC_S_PROTSEQ_NOT_SUPPORTED
Urutan protokol panggilan prosedur jarak jauh tidak didukung.

Keterangan

Fungsi NetEnumerateComputerNames didukung pada Windows Vista dan yang lebih baru.

Fungsi NetEnumerateComputerNames digunakan untuk meminta nama komputer yang saat ini telah dikonfigurasi.

Fungsi NetEnumerateComputerNames mengharuskan penelepon adalah anggota grup lokal Administrator pada komputer target.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header lmjoin.h (termasuk Lm.h)
Pustaka Netapi32.lib
DLL Netapi32.dll

Lihat juga

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx