SFBBTSPPServer

Wrapper Class for the IBTSPPServer interface.

#include <SFBBTSPPServer.h.hpp>

class SFBBTSPPServer : public SFBBTSPP;

SFMTYPEDEFWRAPPER(SFBBTSPPServer)

Version

BREW 2.0	BREW 2.1	BREW 3.1	BREW 4.0
X	X	O	O

Inheritance diagram

Reference

BREW API IBTSPPServer

Member

Public Functions
`SFCError`	Authorize( `BDAddress const ` address , `Bool` accept , `BTResult ` result , `SFXCallbackPtr` callback ) Enable application implementing the SPP server role to either accept or reject the connection request from the client whose BD address is given.
`SFCError`	DisableService( `BTResult *` result , `SFXCallbackPtr` callback ) Close the SPP stream associated with this SPP server.
`SFCError`	EnableService( `BTSecurityLevel` security , `UInt32` channel , `Bool` unregister , `BTResult *` result , `SFXCallbackPtr` callback ) Open up an SPP stream that listens for a connection request from an SPP client and advertises SPP service to inquiring devices.
static `SFBBTSPPServerSmp`	NewInstance( `SFCErrorPtr` exception = null ) Create a new SFBBTSPPServer instance.
static `SFBBTSPPServerSmp`	NewInstance( `AEECLSID` id , `SFCErrorPtr` exception = null ) Create a new SFBBTSPPServer instance.
`SFCError`	OnConnRequest( `SFXCallbackPtr` callback , `BTEventData *` eventData ) Allow the server application to be notified when a client tries to connect to it.
`SFCError`	Close( `Void` ) (inherits from SFBPort) Close an opened port or stops a open in progress.
`SFCError`	Configure( `BTSPPConfig const ` config , `BTResult ` result , `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) Configure the stream.
`SFCError`	Disconnect( `BTResult *` result , `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) Terminate the SPP connection.
static `Bool`	Exhausted( `SInt32` code ) (inherits from SFBSource) Determine if a SFBSource, a SFBPeek, or a SFBGetLine is out of data.
`SFCError`	GetLastError( `Void` ) (inherits from SFBPort) Return the last error that occurred with the SFBPort.
`SFCError`	GetLineError( `BTSPPLineError *` error ) (inherits from SFBBTSPP) Retrieve the stream's current line error.
`SFCError`	GetModemStatus( `BTSPPModemStatus *` status ) (inherits from SFBBTSPP) Retrieve the stream's current modem status.
`SFCError`	GetStatus( `BTSPPStatus *` status ) (inherits from SFBBTSPP) Retrieve the stream's current status.
`SFCError`	IOCtl( `SInt32` option , `UInt32` val ) (inherits from SFBPort) Allow some control over the behaviour of an SFBPort.
`SFCError`	IOCtlEx( `BTSPPIOCtlCommand` command , `BTSPPModemStatus const *` status , `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) This function can be used to control or configure the stream.
`SFCError`	OnLineError( `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) Register a callback to be invoked when a line error occurs on the SPP stream associated with the SPP object.
`SFCError`	OnModemStatusChange( `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) Register a callback to be invoked when there's a change in the modem status associated with the SPP object.
`SFCError`	OnStatusChange( `SFXCallbackPtr` callback ) (inherits from SFBBTSPP) Register a callback to be invoked when there's a change in the SPP stream state associated with the SPP object.
`SFCError`	Open( `ACharConstPtr` port ) (inherits from SFBPort) Open the specified prt.
`SFCError`	Open( `SFXAnsiStringConstRef` port ) (inherits from SFBPort) Open the specified prt.
`SFCError`	QueryInterface( `AEECLSID` clsid , `VoidHandle` handle ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`SFCError`	QueryInterface( `AEECLSID` clsid , `SFBBaseSmpPtr` handle ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`SFBBaseSmp`	QueryInterface( `AEECLSID` clsid ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`SInt32`	Read( `VoidPtr` buf , `SInt32` size ) (inherits from SFBSource) Copy bytes from the source stream to the specified buffer.
`SInt32`	Read( `SFXBufferPtr` buf ) (inherits from SFBSource) Copy bytes from the source stream to the specified buffer.
`Void`	Readable( `SFXCallbackPtr` callback ) (inherits from SFBSource) Schedule a callback to be called when SFBSource::Read() is able to return something other than ISOURCE_WAIT.
`Void`	Self( `AEECLSID` clsidReq , `SFBQuerySmpPtr` clone , `AEECLSID` clsidImp ) (inherits from SFBQuery) Helper macro for those implementing an object with a single interface.
`SFBQuerySmp`	Self( `AEECLSID` clsidReq , `AEECLSID` clsidImp ) (inherits from SFBQuery) Helper macro for those implementing an object with a single interface.
`SInt32`	Write( `ACharConstPtr` port , `SInt32` bufSize ) (inherits from SFBPort) Copy bytes from the specified buffer to the source stream.
`SInt32`	Write( `SFXAnsiStringConstRef` buf ) (inherits from SFBPort) Copy bytes from the specified buffer to the source stream.
`SInt32`	Write( `SFXBufferConstRef` buf ) (inherits from SFBPort) Copy bytes from the specified buffer to the source stream.
`Void`	Writeable( `SFXCallbackPtr` callback ) (inherits from SFBPort) Schedule a function to be called when SFBPort::Write() would return something other than AEEPORT_WAIT.

Protected Functions
static `SFBBaseSmp`	FactoryByCreate( `AEECLSID` id , `SFCErrorPtr` exception = null ) (inherits from SFBBase) Create the instance for the specified ClassID's interface.
static `SFBBaseSmp`	FactoryByQuery( `SFBQuerySmpConstRef` query , `AEECLSID` id , `SFCErrorPtr` exception = null ) (inherits from SFBBase) Create the instance for the specified ClassID's interface using the SFBQuery instance.

SFBBTSPPServer::Authorize

Enable application implementing the SPP server role to either accept or reject the connection request from the client whose BD address is given.

[ public ]
SFCError Authorize(
    BDAddress const * address   // BD address of remote device
    Bool accept                 // true to accept the connection, false to reject
    BTResult * result           // result
    SFXCallbackPtr callback     // called to deliver authorization result
);

Reference

BREW API IBTSPPServer_Authorize

SFBBTSPPServer::DisableService

Close the SPP stream associated with this SPP server.

[ public ]
SFCError DisableService(
    BTResult * result         // result
    SFXCallbackPtr callback   // called to deliver result of disabling the service
);

Reference

BREW API IBTSPPServer_DisableService

SFBBTSPPServer::EnableService

Open up an SPP stream that listens for a connection request from an SPP client and advertises SPP service to inquiring devices.

[ public ]
SFCError EnableService(
    BTSecurityLevel security   // security level for Mode 2 security
    UInt32 channel             // server channel to register the server on
    Bool unregister            // true indicates if the service should be unregistered with SDP when a connection is set up
    BTResult * result          // result
    SFXCallbackPtr callback    // called to deliver result of enabling the service
);

Reference

BREW API IBTSPPServer_EnableService

SFBBTSPPServer::NewInstance

Create a new SFBBTSPPServer instance.

[ public, static ]
SFBBTSPPServerSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBBTSPPServerSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

SFBBTSPPServer::OnConnRequest

Allow the server application to be notified when a client tries to connect to it.

[ public ]
SFCError OnConnRequest(
    SFXCallbackPtr callback   // called to deliver connection request
    BTEventData * eventData   // authorization data
);

Reference

BREW API IBTSPPServer_OnConnRequest