INTF_ENTRY (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure contains detailed information about an interface that is required by an RPC client.

Syntax

typedef struct
{
    LPWSTR          wszGuid;
    LPWSTR          wszDescr;
    ULONG           ulMediaState;
    ULONG           ulMediaType;
    ULONG           ulPhysicalMediaType;
    INT             nInfraMode;
    INT             nAuthMode;
    INT             nWepStatus;
    DWORD           dwCtlFlags;
    DWORD           dwCapabilities;
    RAW_DATA        rdSSID;
    RAW_DATA        rdBSSID;
    RAW_DATA        rdBSSIDList;
    RAW_DATA        rdStSSIDList;
    BOOL            bInitialized;
} INTF_ENTRY, *PINTF_ENTRY;

Members

  • wszGuid
    Pointer to the interface GUID represented as a Unicode string in the following format: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".
  • wszDescr
    Pointer to a string that contains the interface description that is retrieved by the Wireless Automatic Configuration driver (WZCSVC) from NDIS. For more information about this driver, see Automatic Configuration Subsystem.

  • ulMediaState
    Current NDIS media connect state for the interface. The following table shows the possible values that are defined in Ndispnp.h.

    Media State Value

    MEDIA_STATE_CONNECTED

    1

    MEDIA_STATE_DISCONNECTED

    0

    MEDIA_STATE_UNKNOWN

    -1
  • ulMediaType
    NDIS media types that the NIC currently uses. When queried, the value of this member is NdisMedium802_3 as defined in Ndispnp.h. For information about media types, see OID_GEN_MEDIA_IN_USE.
  • ulPhysicalMediaType
    NDIS media type for the interface. When queried, the value of this member is NdisPhysicalMediumWirelessLan as defined in Ndispnp.h. For more information about physical media types, see OID_GEN_PHYSICAL_MEDIUM.
  • nWepStatus
    Current 802.11 Encryption Mode set on the interface. The possible values are defined in the NDIS_802_11_WEP_STATUS enumeration.

  • dwCtlFlags
    Bitmask value that indicates how WZCSVC is operating on the interface. The following table shows the possible bit values.

    Value Description

    INTFCTL_CM_MASK (0x0007)

    Bitmask for the network filter mode. INTFCTL_CM_MASK & dwCtlFlags result in a value of the type NDIS_802_11_NETWORK_INFRASTRUCTURE. The resulting value indicates whether WZCSVC connects only to infrastructure networks, adhoc networks, or to both types of networks.

    INTFCTL_ENABLED (0x8000)

    Indicates whether or not WZCSVC should configure the interface.

    INTFCTL_FALLBACK (0x4000)

    If a preferred network is not available, this value indicates whether WZCSVC should automatically configure the NIC to associate to any available network.

    INTFCTL_OIDSSUPP (0x2000)

    Indicates whether or not the NIC driver supports all the OIDs required by WZCSVC to function.

    INTFCTL_VOLATILE (0x1000)

    Indicates whether or not the control flags for this interface should not be retained in the registry.

    INTFCTL_POLICY (0x0800)

    Indicates whether or not the control flags for this interface are pushed by a group policy.

    INTFCTL_8021XSUPP (0x1000)

    Indicates whether or not 802.1x support is enabled.

  • dwCapabilities
    Specifies the driver capabilities. The following table shows the possible values.

    Value Description

    INTFCAP_MAX_CIPHER_MASK (0x000000ff)

    Bitmask value for the maximum supported cipher. INTFCAP_MAX_CIPHER_MASK & dwCapabilities result in a value of the type NDIS_802_11_WEP_STATUS.

    INTFCAP_SSN (0x00000100)

    Indicates whether or not the NIC driver supports Wireless Protected Access.
  • rdSSID
    Binary data containing the 802.11 SSID currently configured on the interface. The pData member of rdSSID points to an NDIS_802_11_SSID object.
  • rdBSSID
    Binary data containing the 802.11 BSSID configured on the interface specified by an OID_802_11_BSSID value. The pData member of rdBSSID points to a variable of type NDIS_802_11_MAC_ADDRESS.
  • rdStSSIDList
    Binary data that contains the list of preferred networks configured for this interface. The pData member of rdStSSIDList points to a WZC_802_11_CONFIG_LIST object.
  • rdCtrlData
    Binary data used in with other control flags, when setting additional parameters to the interface.
  • pdwOutFlags
    Pointer to DWORD that indicates whether or not data was successfully retrieved by WZCSVC. If this member is set to a non-NULL, WZCSVC sets the same bit values as used for dwCtlFlags, which corresponds to the data that was successfully retrieved. If this indication is not needed, then the caller must set this member to NULL.
  • bInitialized
    Boolean value that determines if the caller using this structure has initialized it successfully.

Remarks

The RAW_DATA structure is defined in Wzcapi.h as follows:

typedef struct
{
    DWORD   dwDataLen;
    LPBYTE  pData;
} RAW_DATA, *PRAW_DATA;

The pData member points to binary data. The dwDataLen indicates the number of bytes pointed by pData.

Requirements

Header wzcsapi.h
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Automatic Configuration Structures
WZCQueryInterface