IDot11AdHocManager::CommitCreatedNetwork method (adhoc.h)

Initializes a created network and optionally commits the network's profile to the profile store. The network must be created using CreateNetwork before calling CommitCreatedNetwork.

Syntax

HRESULT CommitCreatedNetwork(
  [in] IDot11AdHocNetwork *pIAdHoc,
  [in] BOOLEAN            fSaveProfile,
  [in] BOOLEAN            fMakeSavedProfileUserSpecific
);

Parameters

[in] pIAdHoc

A pointer to a IDot11AdHocNetwork interface that specifies the network to be initialized and committed.

[in] fSaveProfile

An optional parameter that specifies whether a wireless profile should be saved. If TRUE, the profile is saved to the profile store. Once a profile has been saved, the user can modify the profile using the Manage Wireless Network user interface. Profiles can also be modified using the Native Wifi Functions.

Saving a profile modifies the network signature returned by IDot11AdHocNetwork::GetSignature.

[in] fMakeSavedProfileUserSpecific

An optional parameter that specifies whether the profile to be saved is an all-user profile. If set to TRUE, the profile is specific to the current user. If set to FALSE, the profile is an all-user profile and can be used by any user logged into the machine. This parameter is ignored if fSaveProfile is FALSE.

By default, only members of the Administrators group can persist an all-user profile. These security settings can be altered using the WlanSetSecuritySettings function. Your application must be launched by a user with sufficient privileges for an all-user profile to be persisted successfully.

If your application is running in a Remote Desktop window, you can only save an all-user profile. User-specific profiles cannot be saved from an application running remotely.

Return value

Possible return values include, but are not limited to, the following.

Requirements

See also

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork