WZCQueryInterfaceEx (Windows Embedded CE 6.0)

1/6/2010

This extended function provides 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 returns information about the WNIC capabilities and version, which is useful for determining whether the network adaptor supports specific security modes.

Syntax

DWORD WZCQueryInterfaceEx(
    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 retrieved from within the data 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, out] On input, pointer to the INTF_ENTRY_EX structure that represents the interface to query.

  On output, requested interface data as a pointer to INTF_ENTRY_EX.

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

On return, the fields selected by dwInFlags from the object pointed by pIntfEntry are populated by WZCSVC. If an indication of the fields that were queried 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 queried successfully.

Requirements

See Also

Reference

Automatic Configuration Functions