Local System Object

INmSysInfo::GetLaunchInfo

HRESULT GetLaunchInfo(
    [out] INmConference **ppConference,
    [out] INmMember **ppMember);

Retrieves information about how this application was launched, including the member who requested the launch and the current associated conference.

Returns one of the following values:

S_OK Success.
E_POINTER The ppConference or ppMember parameter is invalid.
S_FALSE The application was not launched by a remote system, or the original conference is no longer valid.

ppConference: Pointer to a pointer to the INmConference Interface on the current active Conference object, if it still exists. This parameter will be set to NULL if the Conference object no longer exists.
ppMember: Pointer to a pointer to the INmMember Interface on the Member object that requested the application be launched. This parameter can be set to NULL if the Member object is no longer in the conference.

An application launched on a remote node calling INmConference::LaunchRemote can use this method at any time.

If a remote system was used to launch this application, this method can be used to determine that Member object and Conference object.

For more information, see the tutorial.

Back to INmSysInfo

INmSysInfo::GetNmApp

HRESULT GetNmApp(
    [in] REFGUID rguid,
    [out] BSTR *pbstrApplication,
    [out] BSTR *pbstrCommandLine,
    [out] BSTR *pbstrDirectory);

Retrieves the settings for a locally registered NetMeeting application.

Returns one of the following values:

S_OK Success.
E_OUTOFMEMORY The function could not retrieve the parameters.
E_POINTER The pbstrApplication, pbstrCommandLine, or pbstrDirectory parameter is invalid.

rguid: GUID (globally unique identifier) for the registered application.
pbstrApplication: Pointer to a string that contains the full path and file name for the application associated with the rguid parameter.
pbstrCommandLine: Pointer to a BSTR that contains the executable command line to be passed to the application associated with the rguid parameter.
pbstrDirectory: Pointer to a BSTR that contains the current drive and directory for the child process. This string must be a full path and file name that includes a drive letter.

Use INmSysInfo::SetNmApp to register an application.

For more informaiton, see INmConference::LaunchRemote.

INmSysInfo::GetNmchCaps

HRESULT GetNmchCaps(
    [out] ULONG *pchCaps);

Retrieves the channel capabilities of the local computer.

Returns one of the following values:

S_OK Success.
E_POINTER The pchCaps pointer is invalid.
S_FALSE NetMeeting is not running. Information returned may not be valid.

pchCaps

Pointer to a ULONG that contains information on the channel capabilities. Constants may include any combination of the following, or none, in which case NMCH_NULL is used.

NMCH_AUDIO	Audio channel
NMCH_DATA	Data channel
NMCH_FT	File Transfer channel
NMCH_SHARE	Shareable Application channel
NMCH_VIDEO	Video channel

INmSysInfo::GetProperty

HRESULT GetProperty(
    [in] NM_SYSPROP uProp,
    [out] BSTR *pbstrName);

Retrieves information about the Local System object.

Returns one of the following values:

S_OK Success.
E_POINTER pbstrName is an invalid pointer.
E_FAIL Internal resources are not available.

uProp

NM_SYSPROP that identifies the system property type. Constants include:

NM_SYSPROP_EMAIL_NAME	E-mail name.
NM_SYSPROP_RESOLVE_NAME	Resolved name (server/e-mail).
NM_SYSPROP_SERVER_NAME	Server name.
NM_SYSPROP_FIRST_NAME	User's first name.
NM_SYSPROP_LAST_NAME	User's last name.
NM_SYSPROP_USER_CITY	City.
NM_SYSPROP_USER_COMMENTS	User comments.
NM_SYSPROP_USER_COUNTRY	Country (see the comments section for the two-letter country/region codes).
NM_SYSPROP_USER_NAME	User's full name (combined first and last name).
NM_SYSPROP_USER_CATEGORY	Can be one of the following:
	NM_CATEGORY_PERSONAL
	NM_CATEGORY_BUSINESS
	NM_CATEGORY_ADULT
NM_SYSPROP_H323_GATEWAY	IP address of the H323 gateway.
NM_SYSPROP_H323_GATEWAY_ENABLE	Indicates if the H323 gateway is enabled (pbstrName will be 0 if disabled or 1 if enabled).
NM_SYSPROP_INSTALL_DIRECTORY	Path to the directory in which NetMeeting is installed.
NM_SYSPROP_APP_NAME	Node controller name.
NM_SYSPROP_IS_RUNNING	Determines if NetMeeting system is running (pbstrName will contain 0 if the NetMeeting system is not running or 1 if the NetMeeting system is running).
NM_SYSPROP_IN_CONFERENCE	Determines if the local system is currently in a conference (pbstrName will contain 0 if the local system is not in a conference or 1 if the local system is in a conference).

pbstrName

Pointer to a BSTR containing the local user property.

Also see INmSysInfo::SetProperty.

NetMeeting uses the following two-letter country/region codes for NM_SYSPROP_USER_COUNTRY.

AF Afghanistan
AL Albania
DZ Algeria
AD Andorra
AO Angola
AG Antigua And Barbuda
AR Argentina
AM Armenia
AU Australia
AT Austria
AZ Azerbaijan
BS Bahamas
BH Bahrain
BD Bangladesh
BB Barbados
BY Belarus
BE Belgium
BZ Belize
BJ Benin
BT Bhutan
BO Bolivia
BA Bosnia And Herzegovina
BW Botswana
BR Brazil
BN Brunei Darussalam
BG Bulgaria
BF Burkina Faso
BI Burundi
KH Cambodia
CM Cameroon
CA Canada
CV Cape Verde
CF Central African Republic
TD Chad
CL Chile
CN China
CO Colombia
KM Comoros
CG Congo
CR Costa Rica
CI Cote d'Ivoire
HR Croatia
CU Cuba
CY Cyprus
CZ Czech Republic
DK Denmark
DJ Djibouti
DM Dominica
DO Dominican Republic
EC Ecuador
EG Egypt
SV El Salvador
GQ Equatorial Guinea
ER Eritrea
EE Estonia
ET Ethiopia
FJ Fiji
FI Finland
FR France
GA Gabon
GM Gambia, Republic of The
GE Georgia
DE Germany
GH Ghana
GR Greece
GD Grenada
GT Guatemala
GN Guinea
GW Guinea-Bissau
GY Guyana
HT Haiti
HN Honduras
HU Hungary
IS Iceland
IN India
ID Indonesia
IR Iran
IQ Iraq
IE Ireland
IL Israel
IT Italy
JM Jamaica
JP Japan
JO Jordan
KZ Kazakhstan
KE Kenya
KI Kiribati
KP Korea, Democratic People's Republic of
KR Korea, Republic of
KW Kuwait
KG Kyrgyzstan
LA Laos
LV Latvia
LB Lebanon
LS Lesotho
LR Liberia
LY Libyan Arab Jamahiriya
LI Liechtenstein
LT Lithuania
LU Luxembourg
MK Macedonia, Former Yugoslav Republic of
MG Madagascar
MW Malawi
MY Malaysia
MV Maldives
ML Mali
MT Malta
MH Marshall Islands
MR Mauritania
MU Mauritius
MX Mexico
FM Micronesia, Federated States of
MD Moldova
MC Monaco
MN Mongolia
MA Morocco
MZ Mozambique
MM Myanmar
NA Namibia
NR Nauru
NP Nepal
NL Netherlands
NZ New Zealand
NI Nicaragua
NE Niger
NG Nigeria
NO Norway
OM Oman
PK Pakistan
PW Palau
PA Panama
PG Papua New Guinea
PY Paraguay
PE Peru
PH Philippines
PL Poland
PT Portugal
QA Qatar
RO Romania
RU Russian Federation
RW Rwanda
KN Saint Kitts And Nevis
LC Saint Lucia
VC Saint Vincent And The Grenadines
SM San Marino
ST Sao Tome And Principe
SA Saudi Arabia
SN Senegal
SC Seychelles
SL Sierra Leone
SG Singapore
SK Slovakia (Slovak Republic)
SI Slovenia
SB Solomon Islands
SO Somalia
ZA South Africa
ES Spain
LK Sri Lanka
SD Sudan
SR Suriname
SZ Swaziland
SE Sweden
CH Switzerland
SY Syrian Arab Republic
TW Taiwan
TJ Tajikistan
TZ Tanzania, United Repulic of
TH Thailand
TG Togo
TO Tonga
TT Trinidad And Tobago
TN Tunisia
TR Turkey
TM Turkmenistan
TV Tuvalu
UG Uganda
UA Ukraine
AE United Arab Emirates
GB United Kingdom
US United States
UY Uruguay
UZ Uzbekistan
VU Vanuatu
VA Vatican City
VE Venezuela
VN Vietnam
EH Western Sahara
YE Yemen
YU Yugoslavia
ZR Zaire
ZM Zambia
ZW Zimbabwe

INmSysInfo::GetUserData

HRESULT GetUserData(
    [in] REFGUID rguid,
    [out] BYTE **ppb,
    [out] ULONG *pcb);

Retrieves the private data for the local user associated with a specific GUID.

This method is not yet implemented.

Returns one of the following values:

S_OK Success.
E_POINTER The ppb or pcb pointers are invalid.
E_INVALIDARG The rguid parameter is invalid.

rguid: Globally unique identifier (GUID) for the data.
ppb: Pointer to a pointer to the data.
pcb: Pointer to a ULONG containing the size of the data.

Also see INmSysInfo::SetUserData.

INmSysInfo::IsInstalled

HRESULT IsInstalled(void);

Checks to see if NetMeeting is properly installed.

Returns one of the following values:

E_FAIL	No NetMeeting components are installed.
NM_E_NOT_INITIALIZED	One or more NetMeeting settings are not valid.
S_FALSE	The NetMeeting settings appear to be valid, but the NetMeeting wizard has not run.
S_OK	Everything is installed properly.

INmSysInfo::SetNmApp

HRESULT SetNmApp(
    [in] REFGUID rguid,
    [in] BSTR bstrApplication,
    [in] BSTR bstrCommandLine,
    [in] BSTR bstrDirectory);

Registers a local application for remote launching by NetMeeting.

Returns S_OK.

rguid: GUID (globally unique identifier) of the application.
bstrApplication: Full path and file name of the module that will be started when there is an incoming request to launch the application associated with the rguid parameter. The bstrApplication parameter can be NULL. In that case, the module name must be the first white-space-delimited token in the bstrCommandLine string.
bstrCommandLine: Command line to execute. This parameter can be NULL. In that case, the function uses the string pointed to by bstrApplication as the command line.
bstrDirectory: Current drive and directory for the child process. The string must be a full path and file name that includes a drive letter. If this parameter is NULL, the application is started with the same current drive and directory as the calling process.

If all of the bstr parameters are NULL, the entry is deleted from the registry.

For more information, see the tutorial.

For more information, see INmSysInfo::GetNmApp, INmConference::LaunchRemote

INmSysInfo::SetProperty

HRESULT SetProperty(
    [in] NM_SYSPROP uProp,
    [in] BSTR bstrName);

Sets the property of the local user.

Returns S_OK if successful, or E_INVALIDARG if the bstrName string is invalid.

uProp

NM_SYSPROP that identifies the system property type. Constants include:

NM_SYSPROP_EMAIL_NAME	E-mail name.
NM_SYSPROP_RESOLVE_NAME	Resolved name (server/e-mail).
NM_SYSPROP_SERVER_NAME	Server name.
NM_SYSPROP_FIRST_NAME	User's first name.
NM_SYSPROP_LAST_NAME	User's last name.
NM_SYSPROP_USER_CITY	City.
NM_SYSPROP_USER_COMMENTS	User comments.
NM_SYSPROP_USER_COUNTRY	Country (see the comments section for the two-letter country/region codes).
NM_SYSPROP_USER_NAME	User's full name (combined first and last name).
NM_SYSPROP_USER_CATEGORY	Can be one of the following:
	NM_CATEGORY_PERSONAL
	NM_CATEGORY_BUSINESS
	NM_CATEGORY_ADULT
NM_SYSPROP_H323_GATEWAY	IP address of the H323 gateway.
NM_SYSPROP_H323_GATEWAY_ENABLE	Indicates if the H323 gateway is enabled (pbstrName will be 0 if disabled or 1 if enabled).

bstrName

BSTR containing the corresponding property string value.

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. You can set the property after first-time initialization, and the setting will hold for subsequent initializations.

To set NM_SYSPROP_USER_CATEGORY to Personal, pass "1" in the BSTR . To set NM_SYSPROP_USER_CATEGORY to Business, pass " 2"in the BSTR . To set NM_SYSPROP_USER_CATEGORY to Adult, pass " 4"in the BSTR .

When running NetMeeting for the first time, a wizard appears to collect data from the new user. To prevent this for an application in No-UI mode (NM_INIT_CONTROL), the following set of system properties must be set using this method.

NM_SYSPROP_EMAIL_NAME
NM_SYSPROP_SERVER_NAME
NM_SYSPROP_RESOLVE_NAME
NM_SYSPROP_FIRST_NAME
NM_SYSPROP_LAST_NAME
NM_SYSPROP_USER_NAME
NM_SYSPROP_USER_CITY
NM_SYSPROP_USER_COUNTRY
NM_SYSPROP_USER_COMMENTS
NM_SYSPROP_USER_CATEGORY

Also see INmSysInfo::GetProperty.

NetMeeting uses two-letter country/region codes for NM_SYSPROP_USER_COUNTRY.

INmSysInfo::SetUserData

HRESULT SetUserData(
    [in] REFGUID rguid,
    [in] BYTE *pb,
    [in] ULONG cb);

Sets information for the local user that is sent when placing a call and identifies this information with a unique GUID.

This method is not yet implemented.

Returns one of the following values:

S_OK Success.
E_POINTER pb is an invalid pointer.
E_INVALIDARG The rguid parameter is invalid.

rguid: Globally unique identifier (GUID) of the data.
pb: Pointer to the data.
cb: Size of the data that is pointed to by pb.