IJob

Beschreibung:

IJob kapselt den Zugriff auf die Parameter und den Aufruf eines Jobs .

import "OxSvrSpt.idl"

Öffentliche Methoden:

HRESULT Execute ()

Properties:

IOutputParameters OutputParameters [get]
BSTR Name [get]
IInputParameters InputParameters [get]
IErrors Erros [get]
IInputFileParameters InputFileParameters [get]
IOutputFileParameters OutputFileParameters [get]

Dokumentation der Elementfunktionen:

  • HRESULT Execute ()

Nach dem Aufruf dieser Methode stehen die Ausgabeparameter in den Collections OutputParameters und OutputFileParameters bereit. Tritt bei der Ausführung des Jobs ein Fehler auf, wird ein COM-Fehler geworfen. Dies geschieht sowohl bei den logischen, als auch bei den Systemfehlern. Der COM-Fehler enthält die oberste Meldung der Error -Collection. Die weiteren Meldungen können der Error -Collection über die Eigenschaft Errors dieses Objekts entnommen werden.

Beispiele:

VB

' einloggen
Dim oServer As New OxSvrSpt.Server
Dim oSession As OxSvrSpt.Session
Set oSession = oServer.Login("root", "optimal", "localhost", "4000", pwNotEncrypted)
' Job erstellen
Dim oJob As OxSvrSpt.Job
Set oJob = oSession.NewJob("dms.GetResultList")
' Parameter hinzufügen
Dim oParameter As OxSvrSpt.Parameter
oJob.InputParameters.AddNewIntegerParameter "Flags", 16
Set oParameter = oJob.InputParameters.AddNewXMLParameter("XML")
Dim oDomDocument As New MSXML2.DOMDocument40
Dim bSuccess As Boolean
bSuccess = oDomDocument.Load("c:\dmstest.xml")
oDomDocument.save oParameter.Stream
' Job ausführen
oJob.Execute
' XML aus dem XML-Fileparameter auslesen
Dim strXML As String
strXML = oJob.OutputFileParameters(1).XML

C++ über den Import-Mechanismus

#import "../Debug/OxSvrSpt.dll" raw_method_prefix("raw_")
using namespace OxSvrSpt;
// ...
try
{
    _bstr_t bstrUser     = L"root";
    _bstr_t bstrPassword = L"optimal";
    _bstr_t bstrServer   = L"adunkel";
    _bstr_t bstrPort     = L"4000";
    _bstr_t bstrJobName  = L"krn.GetServerInfo";
    OxSvrSpt::IServerPtr  spServer( __uuidof( OxSvrSpt::Server ));
    OxSvrSpt::ISessionPtr spSession = spServer->Login( bstrUser, bstrPassword,
                                          bstrServer, bstrPort, pwNotEncrypted );
    OxSvrSpt::IJobPtr spJob = spSession->NewJob( bstrJobName );
    spJob->InputParameters->AddNewIntegerParameter( L"Flags", 0 );
    spJob->InputParameters->AddNewIntegerParameter( L"Info", 1 );
    spJob->Execute();
    _variant_t varName = spJob->OutputParameters->GetItem( L"Name" )->Value;
}
catch( _com_error& e )
{
    _bstr_t bstrError = e.Description( );
    if( bstrError.length() == 0 )
    {
        bstrError = e.ErrorMessage();
    }
    AfxMessageBox( bstrError );
}

Dokumentation der Properties:

  • IErrors Erros [get]

Errors liefert die Collection mit den beim Server aufgetretenen Fehler zurück

Diese enthält Objekte vom Typ IError .

Parameter:

[out]: pVal (VB-Rückgabewert) Collection mit den aufgetretenen Fehlern

  • IInputFileParameters InputFileParameters [get]

InputFileParameters liefert die Collection mit den FileParametern für die Übergabe an den Server

Diese enthält Objekte vom Typ IFileParametern

Parameter:

[out]: pVal (VB-Rückgabewert) Collection mit den Dateien für den Serveraufruf

  • IInputParameters InputParameters [get]

InputFileParameters liefert die Collection der InputParameters zurück.

Parameter:

[out]: pVal (VB-Rückgabewert) Collection der Input-Parameter

  • BSTR Name [get]

Name liefert den Namen des Jobs .

Der Name des Jobs wird bei der Erstellung des Job -Objektes angegeben und kann anschließend nicht mehr verändert werden.

Parameter:

[out]: pVal (VB-Rückgabewert) Name des Jobs

  • IOutputFileParameters OutputFileParameters [get]

OutputFileParameters liefert die Collection mit den FileParametern die vom Server nach dem Aufruf eines Jobs bereitgestellt werden

Diese enthält Objekte vom Typ IFileParametern

Parameter:

[out]: pVal (VB-Rückgabewert) Collection mit den Ergebnisdateien nach einem Serveraufruf.

  • IOutputParameters OutputParameters [get]

OutputParameters liefert die Collection der Outputparameter zurück

Diese Eigenschaft ist die Standardeigenschaft der IJob -Schnittstelle.

Parameter:

[out]: pVal (VB-Rückgabewert) Collection der Ausgabeparameter des Jobs