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

See Also

Reference

Automatic Configuration Functions