WZCSetInterfaceEx (Windows Embedded CE 6.0)

1/6/2010

This extended function sets detailed information for the specified Wireless Network Interface Card (WNIC) as they are cached in the Wireless Automatic Configuration driver (WZCSVC) as the internal context associated with the interface.

It also sets information about the WNIC capabilities and version, which is useful for determining whether the network adaptor supports specific security modes.

Syntax

DWORD WZCSetInterfaceEx(
    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 set in the INTF_ENTRY_EX object pointed by pIntfEx. This parameter can be a combination of zero or more of the flags. For more information about the INTF_ flags, see Automatic Configuration Constants.

• pIntfEx
  [in] Pointer to the INTF_ENTRY_EX structure.

• pdwOutFlags
  [out] DWORD that indicates the fields that were successfully set. If such an indication is not required, then the application must pass NULL.

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. It also needs to specify the GUID of the interface in the wszGuid member of INTF_ENTRY_EX. The dwInFlags parameter specifies which fields of the INTF_ENTRY_EX object need to be set.

On return, WZCSVC sets in the DWORD pointed by pdwOutFlags the bits corresponding to the fields that were set.

Requirements

See Also

Reference

Automatic Configuration Functions