About This Document

Related Documentation

What this Document Contains

Changes to This Document

Document 3021-006 for CDK 6.0.1

Document 3021-005 for CDK 6.0

Additional Resources

Conventions Used in this Document

Programming Style in This Manual

1 Introduction

COM-based Conduit Fundamentals

Features

Programming Languages

COM Sync Suite Files

Uninstalling the COM Sync Suite

2 Development Basics

HotSync Process

COM Sync Architecture

COM Sync Client/Server DLLs

Client Module Types

Multithreading Support

COM Sync Object Model

System Information Objects

Schema Database Objects

Extended Database Objects

Classic Database Objects

Installation and Support Objects

Expansion Card Objects

COM ProgIDs

COM Error Handling

Database Support and Extensibility

3 Building a Conduit

Requirements

Create the Debug Environment

Synchronizing with Palm OS Simulator

Start a Visual Basic Project

Create the Conduit

Debug the Conduit

Convert Your Conduit to an ActiveX Client

Implement the IPDClientNotify Interface

Developing a Conduit with Visual Basic .NET

Registration Steps

4 Writing an Installer

Installer Tasks

Files to Install

Sample for Registering a COM-based Conduit

Installing Files on the Handheld with PDInstall

How PDInstall Works

Install Directory Terminology

Expansion Slot Support in PDInstall

Controlling HotSync Manager with PDHotSyncUtility

Accessing User Data with PDUserData

Installing an Install Conduit with PDInstallConduit

Registering an Install Conduit

Unregistering an Install Conduit

Adding or Modifying Install Conduit Configuration Entries

Installing a Notifier with PDCondMgr

Uninstalling Your Conduit

Testing Your Installer

Installation Troubleshooting Tips

5 Using Expansion Technology

Expansion Support

Primary vs. Secondary Storage

Expansion Slot

Universal Connector

Architectural Overview

Slot Drivers

File Systems

VFS Manager

Expansion Manager

Standard Directories

Card Insertion and Removal

Checking for Expansion Cards

Is an Expansion Slot Present?

How Many Slots are Present?

Is a Card in the Slot?

Is a Mounted Volume on the Card?

Example of Checking for an Expansion Slot, Card, and Volume

Determining a Card's Capabilities

Volume Operations

Hidden Volumes

Matching Volumes to Slots

Naming Volumes

File Operations

Common File Operations

Naming Files

Working with Palm OS Databases

Directory Operations

Directory Paths

Common Directory Operations

Enumerating the Files and Subdirectories in a Directory

Determining the Default Directory for a Particular File Type

Default Directories Registered at Initialization

Example of Getting a File

Custom Calls

Debugging

Summary of Expansion and VFS Managers