NokSync

KaarPoSoft

• Developing
• Manual
• Features

• Classes
• Globals
• Files
• Translating
• Developing
• Building

INokiaPhonebook Interface Reference

import "INokSync.idl";

Inheritance diagram for INokiaPhonebook:

List of all members.

---

Detailed Description

Contacts in the NOKIA phonebook.

Wrapper around NOKIA's PhonebookAdapterDS3::IPhonebook

Public Member Functions
void	Create (inout long hResult, inout long nmpResult)
	Initialize the INokiaPhonebook structure.
INokiaContact	CreateContact (inout long hResult, inout long nmpResult)
	Create empty contact.
void	DeleteContact (in long location, inout long hResult, inout long nmpResult)
	This deletes the phonebook entry from specified location.
void	Destroy (inout long hResult, inout long nmpResult)
	De-initialize the INokiaPhonebook structure.
INokiaContact	GetFirstContact (inout long hResult, inout long nmpResult)
	Get first contact in phone.
ACString	GetLastErrorString ()
	Return description of last error.
long	GetMemoryCapsFull (inout long hResult, inout long nmpResult)
	Get number of full memory locations.
INokiaContact	GetNextContact (inout long hResult, inout long nmpResult)
	Get next contact in phone.
void	SetContact (in long location, in INokiaContact contact, inout long hResult, inout long nmpResult)
	This method stores the contact in specified memory and location.
void	UpdateContact (in INokiaContact contact, inout long hResult, inout long nmpResult)
	This method stores (changes to) the contact.

---

Member Function Documentation

void INokiaPhonebook::Create	(	inout long	hResult,
		inout long	nmpResult
	)

Initialize the INokiaPhonebook structure.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

INokiaContact INokiaPhonebook::CreateContact	(	inout long	hResult,
		inout long	nmpResult
	)

Create empty contact.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

Returns:

The empty contact created

void INokiaPhonebook::DeleteContact	(	in long	location,
		inout long	hResult,
		inout long	nmpResult
	)

This deletes the phonebook entry from specified location.

Parameters:

	location	Input: Location of entry to delete
	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

void INokiaPhonebook::Destroy	(	inout long	hResult,
		inout long	nmpResult
	)

De-initialize the INokiaPhonebook structure.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

INokiaContact INokiaPhonebook::GetFirstContact	(	inout long	hResult,
		inout long	nmpResult
	)

Get first contact in phone.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

Returns:

The first contact

ACString INokiaPhonebook::GetLastErrorString

(

)

Return description of last error.

Returns:

ACString

long INokiaPhonebook::GetMemoryCapsFull	(	inout long	hResult,
		inout long	nmpResult
	)

Get number of full memory locations.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

Returns:

number of full memory locations (i.e. the number of contacts available)

INokiaContact INokiaPhonebook::GetNextContact	(	inout long	hResult,
		inout long	nmpResult
	)

Get next contact in phone.

Parameters:

	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

Returns:

The next contact

void INokiaPhonebook::SetContact	(	in long	location,
		in INokiaContact	contact,
		inout long	hResult,
		inout long	nmpResult
	)

This method stores the contact in specified memory and location.

Parameters:

	location	Input: Where to store the contact. Zero for next available location
	contact	Input: The contact to store.
	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

void INokiaPhonebook::UpdateContact	(	in INokiaContact	contact,
		inout long	hResult,
		inout long	nmpResult
	)

This method stores (changes to) the contact.

Parameters:

	contact	Input: The contact to update.
	hResult	(see nsresult, hResult and nmpResult in NokSync)
	nmpResult	(see nsresult, hResult and nmpResult in NokSync)

---

The documentation for this interface was generated from the following file:

• INokSync.idl