IVoIPCallerInfoDB::FindCallerInfoByURI

  • Article

This method searches the caller information database for a caller information record that matches the specified URI*.*

HRESULT FindCallerInfoByURI( 
  BSTR bstrURI, 
  IVoIPCallerInfoRecord** ppiRecord 
);

Parameters

  • bstrURI
    [in] The URI of the record to find.

  • ppiRecord
    [out] Pointer to the IVoIPCallerInfoRecord interface for the record that matches the supplied URI. If no record is found, this value is set to NULL.

    If the method succeeds, an object is created. The caller must free this object by using Release when the object is no longer being used.

Return Values

The following table shows the possible return values.

Value Description
VOIP_E_NOTINITIALIZED The database is not initialized.IVoIPCallerInfoDB::Init must be called before this method can complete successfully.
VOIP_E_RECORDNOTINDB Search failed.

Remarks

The VoIP Manager uses the FindCallerInfoByURI method to populate an incoming or outgoing caller's current call record with the user-defined information from a caller information record.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Voipstore.idl.
Link Library: Voipguid.lib.

See Also

VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | IVoIPCallerInfoDB::Init | IVoIPCallerInfoRecord

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.