You are here: Commands > Data Extraction Plug-In Commands > Extract

Extract

The Extract command tells the plug-in to extract the specified profiles / protocol (SCO is a protocol, everything else is a profile). There is no default.

Plugin Command;Plugin Name=Data and Audio Extraction;Command=Extract;Parameters=profiles/protocol

Profiles/protocol consists of a comma-separated list of one or more of the following:

  • A2DP - Advanced Audio Distribution Profile
  • BIP - Basic Imaging Profile
  • BPP - Basic Printing Profile
  • FTP - File Transfer Profile
  • HCRP - Hard-Copy Cable Replacement Profile
  • OPP - Object Push Profile
  • PBAP - Phone Book Access Profile
  • SCO - Synchronous Connection-Oriented link protocol
  • SPP - Serial Port Profile
  • SYNCH - Synchronization Profile

Example command:

Plugin Command;Plugin Name=Data and Audio Extraction;Command=Extract;Parameters=SCO,BIP

In this example, the plug-in immediately responds with the following:

Plugin Command;SUCCEEDED;timestamp;State=11;Description=Command accepted;Plugin=Data Extraction;Command=Extract;Parameters=SCO,BIP

In this example, the plug-in subsequently sends a separate status for each profile / protocol as extraction completes.

Plugin Command;FAILED;timestamp;Reason= 9030;Description=No data found to extract;Profile=BIP;Plugin=Data Extraction;Command=Extract;Parameters=SCO,BIP

Plugin Command;SUCCEEDED;timestamp;State=30;Description=Extraction completed;Protocol=SCO;Plugin=Data Extraction;Command=Extract;Parameters=SCO,BIP