WZCRefreshInterfaceEx (Windows Embedded CE 6.0)
1/6/2010
This extended function refreshes specific information in the interface.
It also refreshes information about the Wireless Network Interface Card (WNIC) capabilities and version, which is useful for determining whether the network adaptor supports specific security modes.
Syntax
DWORD WZCRefreshInterfaceEx(
LPWSTR pSrvAddr,
DWORD dwInFlags,
PINTF_ENTRY_EX pIntfEx,
LPDWORD pdwOutFlags);
Parameters
- pSrvAddr
[in] Not used. This parameter must be set to NULL.
- dwInFlags
[in] Bitmask of flags indicating the fields to be refreshed within the INTF_ENTRY_EX object pointed by pIntfEx. For more information about the INTF_ flags, see Automatic Configuration Constants.
- pIntfEx
[in] Pointer to the INTF_ENTRY_EX object that contains the data about the interface to be refreshed.
- pdwOutFlags
[out] DWORD that indicates the fields that were successfully refreshed.
Return Value
Returns ERROR_SUCCESS if the operation completes successfully; otherwise, returns a Microsoft Win32 error code.
Remarks
When calling this function, the application must pass the address of an allocated INTF_ENTRY_EX object in the pIntfEx parameter. The object must contain the GUID of the interface to be refreshed in the wszGuid member.
On return, the fields selected for refreshing by dwInFlags from the object pointed by pIntfEx are populated by the Wireless Automatic Configuration driver (WZCSVC). If an indication of the fields that were refreshed by the call is not required, then pdwOutFlags must be set to NULL. If pdwOutFlags is not NULL, WZCSVC sets in the DWORD pointed by it the bits corresponding to the fields that were refreshed successfully.
Requirements
| Header | wzcsapi.h |
| Library | Wzcsapi.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |