INmCall::GetAddr

Use the GetAddr method to retrieve the address information of the person being called if this is an outgoing call or the address of the remote computer if this is an incoming call.

HRESULT GetAddr(
BSTR *pbstrAddr,NM_ADDR_TYPE *puType);

Parameters

  • pbstrAddr
    [out] Pointer to the address.
  • puType
    [out] Pointer to a value from the NM_ADDR_* type enumeration that identifies the type of the user name or address.

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 name was retrieved successfully.
  • E_POINTER
    pbstrAddr is an invalid pointer, or puType is invalid.
  • E_FAIL
    Internal resources are not available.

Remarks

The information retrieved by this method may not be available if the call does not have data capabilities (is audio/video only) or if the local or remote computer is running Windows NetMeeting 2.0 or earlier.

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

INmCall, Call Object, Call Object Details