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
| Header | wzcsapi.h |
| Library | Wzcsapi.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |