Struktur NETRESOURCEA (winnetwk.h)

  • Artikel

Struktur berikut berisi informasi tentang sumber daya jaringan. Ini digunakan oleh beberapa fungsi penyedia jaringan, termasuk NPOpenEnum dan NPAddConnection.

Sintaks

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

Anggota

dwScope

Menunjukkan cakupan enumerasi. Ini bisa menjadi salah satu nilai berikut.

Nilai Makna
RESOURCE_CONNECTED
 Koneksi saat ini ke sumber daya jaringan.
RESOURCE_GLOBALNET
 Semua sumber daya jaringan. Ini mungkin atau mungkin tidak tersambung.
RESOURCE_CONTEXT
 Sumber daya jaringan yang terkait dengan konteks jaringan pengguna saat ini dan default. Arti dari ini khusus untuk penyedia.

dwType

Menunjukkan jenis sumber daya. Ini bisa menjadi salah satu nilai berikut.

Nilai Makna
RESOURCETYPE_DISK
 Sumber daya adalah volume disk bersama.
RESOURCETYPE_PRINT
 Sumber daya adalah printer bersama.
RESOURCETYPE_ANY
 Sumber daya cocok dengan lebih dari satu jenis, misalnya, kontainer sumber daya cetak dan disk, atau sumber daya yang bukan cetak atau disk.

dwDisplayType

Atur oleh penyedia untuk menunjukkan jenis tampilan apa yang harus digunakan antarmuka pengguna untuk mewakili sumber daya ini. Jenis berikut ditentukan.

Nilai Makna
RESOURCEDISPLAYTYPE_NETWORK
 Sumber daya adalah penyedia jaringan.
RESOURCEDISPLAYTYPE_DOMAIN
 Sumber daya adalah kumpulan server.
RESOURCEDISPLAYTYPE_SERVER
 Sumber daya adalah server.
RESOURCEDISPLAYTYPE_SHARE
 Sumber daya adalah titik berbagi.
RESOURCEDISPLAYTYPE_DIRECTORY
 Sumber daya adalah direktori.
RESOURCEDISPLAYTYPE_GENERIC
 Jenis sumber daya tidak ditentukan. Nilai ini digunakan oleh penyedia jaringan yang tidak menentukan jenis sumber daya.

dwUsage

Bitmask yang menunjukkan bagaimana Anda dapat menghitung informasi tentang sumber daya. Ini ditentukan hanya jika dwScope diatur ke RESOURCE_GLOBALNET. Bidang dwUsage dapat berisi satu atau beberapa bendera berikut.

Nilai Makna
RESOURCEUSAGE_CONNECTABLE
 Anda dapat menyambungkan ke sumber daya dengan memanggil NPAddConnection. Jika dwType RESOURCETYPE_DISK, maka, setelah Anda terhubung ke sumber daya, Anda dapat menggunakan API sistem file, seperti FindFirstFile, dan FindNextFile, untuk menghitung file dan direktori apa pun yang dikandung sumber daya.
RESOURCEUSAGE_CONTAINER
 Sumber daya adalah kontainer untuk sumber daya lain yang dapat dijumlahkan dengan fungsi NPOpenEnum, NPEnumResource, dan NPCloseEnum .

Namun, kontainer mungkin kosong pada saat enumerasi dibuat. Dengan kata lain, panggilan pertama ke NPEnumResource dapat mengembalikan WN_NO_MORE_ENTRIES.

lpLocalName

Jika dwScope RESOURCE_CONNECTED, bidang lpLocalName berisi nama perangkat yang dialihkan. Jika koneksi adalah koneksi tanpa perangkat, bidang ini berisi NULL.

Jika dwScope tidak diatur ke RESOURCE_CONNECTED, bidang ini tidak terdefinisi.

lpRemoteName

Jika item yang dijumlahkan adalah sumber daya jaringan, bidang ini berisi nama jaringan jarak jauh. Nama ini kemudian dapat diteruskan ke NPAddConnection untuk membuat koneksi jaringan jika dwUsage diatur ke RESOURCEUSAGE_CONNECTABLE. Jika item yang dijumlahkan adalah koneksi saat ini, bidang ini akan merujuk ke nama jaringan jarak jauh yang tersambung dengan lpLocalName .

lpComment

Mungkin setiap komentar yang disediakan penyedia yang terkait dengan item yang dijumlahkan.

lpProvider

Menentukan nama penyedia yang memiliki item enumerasi ini.

Keterangan

Catatan

Header winnetwk.h mendefinisikan NETRESOURCE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header winnetwk.h