Share via

INmManager::CreateCall

  • Article

The CreateCall method creates a new Call object that represents an outgoing call to a remote computer.

HRESULT CreateCall(
INmCall **ppCall,NM_CALL_TYPEcallType,NM_ADDR_TYPEuType, BSTRbstrAddr,INmConference *pConference);

Parameters

  • ppCall
    [out] Pointer to a location for the INmCall interface pointer on a Call object. Can be set to NULL if the application does not need to use the returned Call object.
  • callType
    [in] A value from NM_CALL_* type enumeration that identifies call types.
  • uType
    [in] A value from the NM_ADDR_* type enumeration that identifies the type of the user name or address.
  • bstrAddr
    [in] A string that contains the target of the call. Depending on the uType constant, this may take the form of an IP address, a computer name, an Internet Locator Service (ILS) server name, or the gateway server and telephone number. See the following Remarks section.
  • pConference
    [in] Pointer to the INmConference interface pointer on a Conference object. If pConference is NULL, this method uses the current active Conference object or creates a new one, if needed.

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 call was created successfully.
  • E_INVALIDARG
    The bstrAddr string is invalid, or uType is not one of the valid types.
  • E_FAIL
    The Conference Manager object was not initialized, or internal resources are not available.
  • E_OUTOFMEMORY
    Memory could not be allocated to service the request.
  • NM_E_NOT_ACTIVE
    NetMeeting is not running.
  • NM_E_NOT_INITIALIZED
    The Conference Manager object was not initialized.

Remarks

If uType is NM_ADDR_H323_GATEWAY, the bstrAddr string must take the form IP address/number, or "www.xxx.yyy.zzz/number". IP address is the address of the gateway to use, and number is the phone number to dial. The allowed character set for the "number" half of bstrAddr is comprised of the following characters: 0123456789#*. NetMeeting will automatically strip extraneous characters. For example, the string "(425) 555 - 1212" becomes "4255551212" when it is passed to the gateway.

If uType is NM_ADDR_T120_TRANSPORT, the callType should be NM_CALL_T120, bstrAddr should be the string that was returned in pbstrConnectionID from IPluggableTransport::CreateConnection.

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.