WZCRefreshInterface 函式

從 Windows Vista 和 Windows Server 2008 起，不支援 [WZCRefreshInterface ]。請改用原生 Wifi API，以提供類似的功能。如需詳細資訊，請參閱關於原生 Wifi API。]

WZCRefreshInterface函式會重新整理特定無線區域網路介面的介面資訊。

語法

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

pSrvAddr [in]

字串的指標，包含執行此函式的電腦名稱稱。如果此參數為 Null，則會在本機電腦上呼叫無線零組態服務。

如果指定的 pSrvAddr 參數是遠端電腦，則遠端電腦必須支援遠端 RPC 呼叫。

dwInFlags [in]

要重新整理的一組欄位，以及要採取的特定重新整理動作。這是位元遮罩，可以包含下列旗標的任何組合。

值	意義
INTF_DESCR 0x00010000	重新整理無線區域網路介面的介面描述。呼叫WZCQueryInterface函式，並在dwInFlags參數中設定INTF_DESCR位，即可擷取重新整理的介面描述。介面描述會在WZCQueryInterface函式所傳回之pIntf參數所指向之INTF_ENTRY結構的wszDescr成員中傳回。
INTF_NDISMEDIA 0x00020000	重新整理無線區域網路介面的 NDIS 媒體資訊。藉由呼叫WZCQueryInterface函式，並在dwInFlags參數中設定INTF_NDISMEDIA位，即可擷取重新整理的 NDIS 媒體資訊。 NDIS 媒體資訊會在WZCQueryInterface函式所傳回之pIntf參數所指向之INTF_ENTRY結構的ulMediaState、ulMediaType和ulPhysicalMediaType成員中傳回。
INTF_ALL_OIDS 0xFFF00000	重新整理無線區域網路介面的所有 NDIS OID。此選項會重新整理無線區域網路介面的大部分資料。您可以藉由呼叫 WZCQueryInterface 函式來擷取重新整理的資訊。

pIntf [in]

包含要重新整理之介面索引鍵 之INTF_ENTRY 結構的指標。

pdwOutFlags [out]

已成功重新整理的一組欄位。

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼	描述
ERROR_ARENA_TRASHED	儲存控制區塊已終結。如果無線零設定服務尚未初始化內建物件，就會傳回此錯誤。
ERROR_FILE_NOT_FOUND	系統找不到指定的檔案。如果pIntf參數所指向之 INTF_ENTRY結構wszGuid成員中的 GUID 不符合本機電腦上的任何無線區域網路介面，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。如果 pIntf 參數為 Null，就會傳回此錯誤。如果pIntf參數所指向之INTF_ENTRY結構的wszGuid成員為Null，就會傳回此錯誤。
RPC_STATUS	各種錯誤碼。

pIntf參數所指向之INTF_ENTRY結構的wszGuid成員必須包含無線區域網路介面的介面 GUID。您可以藉由呼叫 WZCEnumInterfaces 函式來擷取無線區域網路介面清單。

注意

Windows SDK 中無法使用 Wzcsapi.h 標頭檔與 Wzcsapi.lib 匯入程式庫檔案。