|
wstring PolicyProfiles::AddProfile |
( |
int |
nPolicy, |
|
|
wstring |
szwName, |
|
|
params |
pAttrs, |
|
|
int |
nLifeTime |
|
) |
| |
Create a new profile.
Creates a new profile with the specified name. The method returns identifier of opened SsContents, that must be filled by the client.
Actually the profile is saved only after the returned SsContents is filled with one or more sections, and SsContents::Ss_Apply method is called. So, the SsContents::Ss_Apply method may also throw an exception if the profile is not unique.
- Note:
- Don't forget to fill returned SsContents, and call SsContents::Ss_Apply and SsContents::SS_Release methods
- Parameters:
-
nPolicy | (int) policy id |
szwName | (wstring) profile name, a non-empty string, up to 100 unicode characters |
pAttrs | (params) profile data, following attributes may be specified in the policy format
- EXPRESSION (required)
- KLSSPOL_PRF_ENABLED (optional, false by default)
|
nLifeTime | (int) timeout in milliseconds to keep this SsContents object alive, zero means 'default value' |
- Returns:
- (wstring) identifier of opened SsContents, must be closed with SsContents::SS_Release
- See also:
-
|