INapComponentConfig2::InvokeUIFromConfigBlob method

The InvokeUIFromConfigBlob method is implemented by system health validators (SHVs) as needed to load the configuration of a remote or local machine in memory and display a UI that allows manipulation of the configuration data. The configuration component must support the usage of INapComponentConfig through DCOM.

Syntax

HRESULT InvokeUIFromConfigBlob(
  [in, unique] HWND   hwndParent,
  [in]         UINT16 inbCount,
  [in]         BYTE   *inData,
  [out]        UINT16 *outbCount,
  [out]        BYTE   **outdata,
  [out]        BOOL   *fConfigChanged
);

Parameters

hwndParent [in]

A handle to the parent or owner window. A valid window handle must be supplied.

inbCount [in]

The size, in bytes, of inData.

inData [in]

A pointer to a buffer that stores the initial configuration data. This data is exported from the remote or local machine.

outbCount [out]

The size, in bytes, of outdata.

outdata [out]

A pointer to a buffer that stores configuration data changed by the SHV configuration user interface. This data is imported by the remote or local machine.

fConfigChanged [out]

A pointer to a BOOL that is set to TRUE if the configuration was changed during the UI operation and FALSE otherwise.

Return value

Returns S_OK if successful, or one of the standard Windows error codes.

Remarks

If used for a local machine, this function can be used for per policy SHV configuration. It provides a way to invoke an SHV UI and edit an existing SHV configuration.

Requirements

See also

INapComponentConfig2