Fungsi WZCRefreshInterface

Artikel
06/13/2023

[WZCRefreshInterface tidak didukung pada Windows Vista dan Windows Server 2008. Sebagai gantinya, gunakan NAtive Wifi API, yang menyediakan fungsionalitas serupa. Untuk informasi selengkapnya, lihat Tentang API Wifi Asli.]

Fungsi WZCRefreshInterface menyegarkan informasi antarmuka untuk antarmuka LAN nirkabel tertentu.

Sintaks

DWORD WZCRefreshInterface(
  _In_  LPWSTR      pSrvAddr,
  _In_  DWORD       dwInFlags,
  _In_  PINTF_ENTRY pIntf,
  _Out_ LPDWORD     pdwOutFlags
);

Parameter

pSrvAddr [in]

Penunjuk ke string yang berisi nama komputer untuk menjalankan fungsi ini. Jika parameter ini NULL, maka layanan Konfigurasi Nol Nirkabel dipanggil pada komputer lokal.

Jika parameter pSrvAddr yang ditentukan adalah komputer jarak jauh, komputer jarak jauh harus mendukung panggilan RPC jarak jauh.

dwInFlags [in]

Sekumpulan bidang yang akan disegarkan bersama dengan tindakan refresh tertentu yang akan diambil. Ini adalah bitmask yang dapat berisi kombinasi bendera berikut.

Nilai	Makna
INTF_DESCR 0x00010000	Refresh deskripsi antarmuka untuk antarmuka LAN nirkabel. Deskripsi antarmuka yang di-refresh dapat diambil dengan memanggil fungsi WZCQueryInterface dengan bit INTF_DESCR diatur dalam parameter dwInFlags . Deskripsi antarmuka dikembalikan dalam anggota wszDescr dari struktur INTF_ENTRY yang ditunjukkan oleh parameter pIntf yang dikembalikan oleh fungsi WZCQueryInterface .
INTF_NDISMEDIA 0x00020000	Refresh informasi media NDIS untuk antarmuka LAN nirkabel. Informasi media NDIS yang disegarkan dapat diambil dengan memanggil fungsi WZCQueryInterface dengan bit INTF_NDISMEDIA diatur dalam parameter dwInFlags . Informasi media NDIS dikembalikan dalam anggota ulMediaState, ulMediaType, dan ulPhysicalMediaType dari struktur INTF_ENTRY yang ditunjukkan oleh parameter pIntf yang dikembalikan oleh fungsi WZCQueryInterface .
INTF_ALL_OIDS 0xFFF00000	Refresh semua OID NDIS untuk antarmuka LAN nirkabel. Opsi ini me-refresh sebagian besar data untuk antarmuka LAN nirkabel. Informasi yang disegarkan dapat diambil dengan memanggil fungsi WZCQueryInterface .

pIntf [in]

Penunjuk ke struktur INTF_ENTRY yang berisi kunci antarmuka yang akan disegarkan.

pdwOutFlags [out]

Sekumpulan bidang yang berhasil disegarkan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin salah satu kode pengembalian berikut.

Menampilkan kode	Deskripsi
ERROR_ARENA_TRASHED	Blok kontrol penyimpanan dihancurkan. Kesalahan ini dikembalikan jika layanan Konfigurasi Nol Nirkabel belum menginisialisasi objek internal.
ERROR_FILE_NOT_FOUND	Sistem tidak dapat menemukan file yang ditentukan. Kesalahan ini dikembalikan jika GUID di anggota wszGuid dari struktur INTF_ENTRY yang ditunjukkan oleh parameter pIntf tidak cocok dengan antarmuka LAN nirkabel pada komputer lokal.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter pIntf adalah NULL. Kesalahan ini dikembalikan jika anggota wszGuid dari struktur INTF_ENTRY yang ditujukkan oleh parameter pIntf adalah NULL.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Anggota wszGuid dari struktur INTF_ENTRY yang ditunjukkan oleh parameter pIntf harus berisi GUID antarmuka untuk antarmuka LAN nirkabel. Daftar antarmuka LAN nirkabel dapat diambil dengan memanggil fungsi WZCEnumInterfaces .

Catatan

File header Wzcsapi.h dan file pustaka impor Wzcsapi.lib tidak tersedia di Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP dengan SP3
Akhir dukungan server	Windows Server 2003
Header	Wzcsapi.h
Pustaka	Wzcsapi.lib
DLL	Wzcsapi.dll

Lihat juga

WZCEapolGetInterfaceParams
WZCEnumInterfaces
WZCQueryInterface
INTF_ENTRY

Bagikan melalui