WZCQueryInterface
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function provides detailed information for the specified Wireless NIC as they are cached in the driver (WZCSVC) as the internal context associated with the interface.
Syntax
DWORD WZCQueryInterface(
LPWSTR pSrvAddr,
DWORD dwInFlags,
PINTF_ENTRY pIntf,
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 pIntf. This parameter can be a combination of zero or more of the flags. For more information about the INTF_ flags see Automatic Configuration Constants.
pIntf
[in, out] On input, pointer to the INTF_ENTRY structure that represents the interface to query.On output, requested interface data as a pointer to INTF_ENTRY.
- 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 object in the pIntf parameter. It also needs to specify the GUID of the interface to query in the wszGuid member of INTF_ENTRY. The dwInFlags parameter specifies which fields of the INTF_ENTRY 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 CE .NET 4.2 and later |