INetCfgComponentPropertyUi::QueryPropertyUi method
The QueryPropertyUi method determines if the given context is the appropriate one to display properties for the network component that owns the notify object.
Syntax
HRESULT QueryPropertyUi(
[in] IUnknown *pUnk
);
Parameters
- pUnk [in]
Pointer to the IUnknown interface. QueryPropertyUi retrieves from IUnknown the interface of the context for displaying properties for the network component that owns the notify object.
Return value
Returns zero (S_OK) if successful, indicating that the network configuration subsystem can subsequently call any other method of the notify object's INetCfgComponentPropertyUi interface, such as SetContext and MergePropPages. Returns S_FALSE if users should not be allowed to display properties for the network component in the given context. Otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.
Remarks
The network configuration subsystem calls QueryPropertyUi before calling any other method of the INetCfgComponentPropertyUi interface.
The network configuration subsystem calls QueryPropertyUi and passes a context to determine if users should be able to display properties for the network component that the notify object belongs to in that context.
Implementations of QueryPropertyUi can simply return S_OK to indicate that subsequent calls to SetContext and MergePropPages are permitted.
Requirements
Target platform |
Desktop |
Header |
Netcfgn.h (include Netcfgn.h) |
See also
INetCfgComponentPropertyUi::MergePropPages
INetCfgComponentPropertyUi::SetContext