INapComponentConfig3::NewConfig method

Note

The Network Access Protection platform is not available starting with Windows 10

The NewConfig method is implemented by system health validators (SHVs) to provide a way to create configuration data for a specific configuration ID. When this function is called, an SHV must allocate new configuration data and populate it with a copy of the default configuration data.

Syntax

HRESULT NewConfig(
   UINT32 configID
);

Parameters

configID

A value that represents the configuration. ConfigID is assigned by the Network Policy Server (NPS) service and is unique within the SHV.

Return value

Returns one of the following error codes based on the result of this operation.

Return code Description
S_OK
The operation is successful.
E_INVALIDARG
ConfigID is 0 (a value reserved for the default configuration).
NAP_E_SHV_CONFIG_EXISTED
ConfigID already exists. The list of IDs known to NPS is different from the SHV.

Remarks

After the new configuration is created by NewConfig, the GetConfigFromID, InvokeUIFromConfigBlob, and SetConfigToID methods should be used to alter the configuration as needed.

Requirements

Requirement Value
Minimum supported client
None supported
Minimum supported server
Windows Server 2008 R2 [desktop apps only]
Header
NapCommon.h
IDL
NapCommon.idl

See also

INapComponentConfig3