INmSysInfo::SetProperty
Use the SetProperty method to set information about the Local System object.
HRESULT SetProperty(
NM_SYSPROP uProp, BSTR bstrName);
Parameters
- uProp
[in] A value from the NM_SYSPROP_* property identifier enumeration that identifies a system property. - bstrName
[in] The corresponding property string value for the property identified by uProp.
Return Values
NetMeeting client applications can use the SUCCEEDED and FAILED macros in winerror.h to check return values.
Return values can include RPC layer errors or any of the following values:
- S_OK
The property value was set successfully. - E_INVALIDARG
The bstrName string is invalid.
Remarks
To set NM_SYSPROP_USER_CATEGORY to Personal, pass NM_CATEGORY_PERSONAL in bstrName. To set NM_SYSPROP_USER_CATEGORY to Business, pass NM_CATEGORY_BUSINESS in bstrName. To set NM_SYSPROP_USER_CATEGORY to Adult, pass NM_CATEGORY_ADULT in bstrName.
If you set the NM_SYSPROP_USER_NAME property before first-time initialization, it will be overwritten by the concatenation of NM_SYSPROP_FIRST_NAME and NM_SYSPROP_LAST_NAME. When you set the property after first-time initialization, the setting will hold for subsequent initializations.
When a client application runs NetMeeting for the first time, a wizard application collects data from the new user. For NetMeeting clients that have initialized NetMeeting with NM_INIT_CONTROL, see Disabling the NetMeeting Wizard.
Requirements
** Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
** Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
** Header:** Imsconf2.idl.
See Also
INmSysInfo, INmSysInfo::GetProperty, Local System Object, Local System Object Details