Struktur NETRESOURCEA (winnetwk.h)
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.
dwType
Menunjukkan jenis sumber daya. Ini bisa menjadi salah satu nilai berikut.
dwDisplayType
Atur oleh penyedia untuk menunjukkan jenis tampilan apa yang harus digunakan antarmuka pengguna untuk mewakili sumber daya ini. Jenis berikut ditentukan.
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 |
---|---|
|
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. |
|
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 |