Recommendation for Space Data System Practices

The interface provides the means to configure the proxy component and to pass it the interfaces needed operationally. All static configuration parameters needed by the proxy are defined in a configuration file. The path name of that file is supplied to the proxy via this interface.

In addition, the interface provides methods to register and de-register ports for a specific service instance. These methods are used by the service element when a service instance is created and deleted. Port registration is described in 3.2.5.

The interface finally provides a method for shutdown of the proxy.

#include

#include

#include

interface ISLE_Locator;

interface ISLE_OperationFactory;

interface ISLE_UtilFactory;

interface ISLE_Reporter;

interface ISLE_SII;
#define IID_ISLE_ProxyAdmin_DEF { 0xd020b00c, 0xccd1, 0x11d2, \

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

{

virtual HRESULT

ISLE_Locator* plocator,

ISLE_OperationFactory* popFactory,

ISLE_UtilFactory* putilFactory,

ISLE_Reporter* preporter ) = 0;

virtual HRESULT

ShutDown() = 0;

virtual HRESULT

RegisterPort( const ISLE_SII& sii,

const char* responderPort,

SLE_PortRegId& regId ) = 0;

virtual HRESULT

DeregisterPort( SLE_PortRegId regId ) = 0;

virtual const char*

Get_ProtocolId() const = 0;

};

Methods

Configures the proxy and passes it the basic interfaces of other components needed for operations. As part of this method, the proxy also configures and initializes the communications system. Any problems and errors are entered into the system log using the interface passed as argument.

Requests the proxy to shutdown and release all resources.

Registers a port. Port registration actions are technology and implementation dependent. The method must be called for every new service instance responding to BIND invocations, as the proxy may depend on this procedure.

De-registers a port that has been previously registered.

Returns the identifier for the protocol supported by the proxy.

32. 
    Association Factory
    

The interface allows creation of associations that take the initiator role for the BIND operation. Associations created via this interface can be used for several consecutive associations for the same service instance. When the association is no longer needed, the proxy must be instructed to destroy the association. In addition, clients must make sure that all references on the interface have been released.

#include

#include

#include

interface ISLE_SrvProxyInitiate;

interface ISLE_SrvProxyInform;

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

{

virtual HRESULT

SLE_ApplicationIdentifier srvType,

ISLE_SrvProxyInform* pclientIf,

void** ppv ) = 0;

virtual HRESULT

DestroyAssociation( IUnknown* passoc ) = 0;

};

Methods__HRESULT_CreateAssociation(_const_GUID_iid,_SLE_AppplicationIdentifier_srvType,_ISLE_SrvProxyInform*_pclientIf,_void**_ppv_);'>Methods

HRESULT CreateAssociation( const GUID& iid,
SLE_AppplicationIdentifier srvType,
ISLE_SrvProxyInform* pclientIf,
void** ppv );

Creates a new association of the specified service type, which acts as an initiator for the BIND operation. If the proxy does not support the service type or the specified interface it returns an error.

Deletes an association previously created by this interface.

33. 
    SLE Service Proxy Interface
    

The interface allows a client to pass SLE operation invocations and returns to an association in the proxy for transmission to the peer system.

The association accepts any operation that is valid for the given service type, independent of the service instance state and whether the clients acts as an SLE service user or provider. The only checks applied are related to the state of the association.

(For a description of the associated state table of an association see 4.)

#include

#include

interface ISLE_Operation;

interface ISLE_ConfirmedOperation;
#define IID_ISLE_SrvProxyInitiate_DEF { 0xd020b00e, 0xccd1, 0x11d2, \

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

{

virtual HRESULT

bool reportTransmission = false,

unsigned long seqCount = 0 ) = 0;

virtual HRESULT

InitiateOpReturn( ISLE_ConfirmedOperation* poperation,

bool report = false,

unsigned long seqCount = 0 ) = 0;

virtual HRESULT

DiscardBuffer() = 0;

virtual SLE_AssocState

Get_AssocState() const = 0;

};

Methods__HRESULT_Configure(_const_char*_configFilePath,_ISLE_OperationFactory*_popFactory,_ISLE_UtilFactory*_putilFactory,_ISLE_Reporter*_preporter_);'>Methods

Queues the operation invocation defined by the argument poperation for transmission. If the argument reportTransmission is set to true final transmission is reported via the interface ISLE_SrvProxyInform. If the operation is confirmed, the association returns it when the associated return arrives.

Queues the operation return defined by the argument poperation for transmission. If the argument reportTransmission is set to true final transmission is reported via the interface ISLE_SrvProxyInform.

Searches the local transmission queue of operations of the type TRANSFER BUFFER, and deletes all objects for which transmission of data has not yet started. Returns whether any buffer has been discarded.

Returns the current state of the association.

1. 
   SLE API Service Element
   
1. 
   Component Creator Function
   

extern "C" HRESULT

_CreateServiceElement( const GUID& iid,

void** ppv );

where is replaced by the product identifier of the implementation. External ‘C’ linkage is required. The function ensures that a single instance of the proxy is created and returns the same instance if it is called repetitively. The function checks the argument identifying the interface and returns an error when the implementation does not support an interface with this identifier.

Arguments

iid identifier of the required interface

ppv pointer to the requested interface of the API Service Element

Result codes

S_OK the object has been created

E_NOINTERFACE the specified interface is not supported

35. 
    API Service Element Administrative Interface
    

Name ISLE_SEAdmin

GUID {24396FC0-CD99-11d2-9B44-00A0246D80DB}

Inheritance: IUnknown

File ISLE_SEAdmin.H

The interface provides the means to configure the service element component and to pass it the interfaces needed operationally. All static configuration parameters needed by the component are defined in a configuration file. The path name of that file is supplied to the proxy via this interface.

Clients must first call the method Configure() and then call AddProxy() to pass a pointer to the proxy component for every proxy that shall be supported.

The interface finally provides a method for shutdown of the service element.

Synopsis

#include

#include

interface ISLE_OperationFactory;

interface ISLE_UtilFactory;

interface ISLE_Reporter;

interface ISLE_ProxyAdmin;
#define IID_ISLE_SEAdmin_DEF { 0x24396fc0, 0xcd99, 0x11d2, \

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

interface ISLE_SEAdmin : IUnknown

{

virtual HRESULT

Configure( const char* configFilePath,

ISLE_OperationFactory* popFactory,

ISLE_UtilFactory* putilFactory,

ISLE_Reporter* preporter ) = 0;

virtual HRESULT

AddProxy( const char* protocolId,

SLE_BindRole role,

ISLE_ProxyAdmin* pproxy ) = 0;

virtual HRESULT

ShutDown() = 0;

};

Methods

HRESULT Configure( const char* configFilePath,
ISLE_OperationFactory* popFactory,
ISLE_UtilFactory* putilFactory,
ISLE_Reporter* preporter );

Configures the service element component and passes it the basic interfaces of other components needed for operations. Any problems and errors are entered into the system log using the interface passed as argument.

Arguments

configFilePath full path name of the configuration file; the contents of this file is implementation dependent

popFactory pointer to the operation object factory to be used by the service element

putilFactory pointer to the factory interface for utility objects to be used by the service element

preporter pointer to the reporter interface for passing of log messages and notifications to the application

Result codes

S_OK configuration completed without errors

SLE_E_NOFILE configuration file not found

SLE_E_CONFIG errors or inconsistencies in the configuration data

E_INVALIDARG one of the input arguments is NULL

E_FAIL the request fails because of a further unspecified error

HRESULT AddProxy( const char* protocolId,
SLE_BindRole role,
ISLE_ProxyAdmin* pproxy );

Passes the proxy component to use to the service element.

Arguments

protocolId identification of the technology and mapping supported by the proxy; this argument is required for selection of the correct proxy when multiple proxies are configured

role the bind roles supported by the API proxy component

pproxy pointer to the administrative interface of the proxy

Result codes

S_OK proxy added

SLE_E_OVERFLOW too many proxies

SLE_E_DUPLICATE protocol identifier already used by a configured proxy

E_FAIL the request fails because of a further unspecified error

36. 
    Service Instance Locator
    

Name ISLE_Locator

GUID {24396FC1-CD99-11d2-9B44-00A0246D80DB}

Inheritance: IUnknown

File ISLE_Locator.H

The interface is provided to the proxy to obtain an interface of the type ISLE_SrvProxyInform when a BIND invocation has been received. When an error is returned, the proxy is expected to reject the BIND invocation.

Synopsis

#include

interface ISLE_Bind;

interface ISLE_SrvProxyInform;

interface ISLE_SrvProxyInitiate;
#define IID_ISLE_Locator_DEF { 0x24396fc1, 0xcd99, 0x11d2, \

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

interface ISLE_Locator : IUnknown

{

virtual HRESULT

LocateInstance( ISLE_SrvProxyInitiate* passociation,

ISLE_Bind* pbindop,

ISLE_SrvProxyInform** ppServiceInstance) = 0;

};

Methods

HRESULT LocateInstance( ISLE_SrvProxyInitiate* passociation,
ISLE_Bind* pbindop
ISLE_SrvProxyInform** ppServiceInstance);

Obtains and returns an interface ISLE_SrvProxyInform for use by a new association. To locate (or create) the object implementing ISLE_SrvProxyInform, the BIND operation is made available, which contains all information needed. The interface ISLE_SrvProxyInitiate is made available to the object providing the returned interface ISLE_SrvProxyInform.

If no interface can be made available returns an error and sets the output argument to NULL. In this case the proxy is expected to reject the BIND invocation by a BIND return with a negative response and a diagnostic corresponding to the returned error.

An implementation is not required to perform all the checks defined by the result codes in this method. It can also accept the association and perform the checks when the BIND invocation is passed to the interface ISLE_SrvProxyInform.

Arguments

passociation interface provided by the association on which the BIND invocation was received

pbindop bind operation object holding the received bind invocation

ppServiceInstance complementary interface that shall be used by the association to forward PDUs received from the network

Result codes

S_OK a service instance has been located and is ready to accept the BIND invocation

SLE_E_UNKNOWN the service instance identifier in the BIND invocation does not match any available service instance

E_ACCESSDENIED the service instance does not belong to the peer application as identified by the application identifier in the BIND operation

SLE_E_TYPE the service type specification in the BIND operation does not match the service type in the service instance

SLE_E_TIME the scheduled provision period of the service instance has not yet started or has expired

SLE_E_STATE the service instance is already bound

E_FAIL the request fails because of a further unspecified error

37. 
    SLE Service Instance Factory
    

Directory: sec -> docs -> 201510 Documents for SC13 Submission
sec -> Security Education Narrative Database Patterns of Professional Education
sec -> Guidelines for implementation of Prime Minister’s New 15 Point Programme for the Welfare of Minorities
sec -> Morphodynamics of a Constructed Marsh: Project Greenshores, Pensacola, Florida
sec -> Registration 6: 00pm – 6: 10pm Welcome/Opening Remarks
sec -> ¡bienvenidos! Welcome to Puerto Rico! 2 Things to know immediately upon arrival 2
sec -> Cadillac Racing cts-v coupe Media Kit
sec -> Sure Bet Narrative Nonfiction Suggestions
sec -> Executive Board of the United Nations Development Programme, the United Nations Population Fund and the United Nations Office for Project Services
201510 Documents for SC13 Submission -> Recommendation for Space Data System Practices

Download 2.26 Mb.

Share with your friends: