WZCQueryInterface (Windows Embedded CE 6.0)

1/6/2010

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

See Also

Reference

Automatic Configuration Functions