Share via

INmSysInfo::GetProperty

  • Article

Use the GetProperty method to retrieve information about the Local System object.

HRESULT GetProperty(
  NM_SYSPROP uProp,  BSTR *pbstrName);

Parameters

  • uProp
    [in] A value from the NM_SYSPROP_* property enumeration that identifies the system property identifier.
  • pbstrName
    [out] Pointer to a location containing the property name of the local user.

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 retrieved successfully.
  • E_POINTER
    pbstrName is an invalid pointer.
  • E_FAIL
    Internal resources are not available.

Remarks

Note  When retrieving system properties using INmSysInfo::GetProperty, versions earlier than NetMeeting 3 do not return S_OK when an unrecognized NM_SYSPROP_* identifier is passed in the uProp parameter. Use this fact to detect newer system properties. The following example shows a call to retrieve the build version.

    hr = GetProperty(NM_SYSPROP_BUILD_VER, &pbstrProperty)

If the method returns S_OK, the build number is in the string pointed to by pbstrProperty. If the method returns a value other than S_OK, a version earlier than NetMeeting 3 is running.

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, Local System Object, Local System Object Details, Disabling the NetMeeting Wizard