hospitalCreditRequest generates a credit request
for role=physician and place=hospital
hospitalCreditRequest
    API DocBrowser   ·  Revision history
    Download area
    FAQ
 
home
system
integrators
search the
site
 

validator
modules
invoice
modules
credit
modules
miscellaneous
modules
tools

  Design by TMR AG
  © by sumex1.net
 
IHospitalCreditRequestManager::GetHospitalCreditRequest method

Description  V4.10/28 Sep 2005 
Gets the HospitalCreditRequest instance used to define the data and parameters for a credit request.

New feature: by supplying a well-formed and valid V4.1 XML content or XML file path in the variable bstrSoftwarePackage the IHospitalCreditRequest interface is generated and populated with these XML data. The variable lSoftwareVersion is used to control the timestamp and resendID status (cf. below). Subsequently one can e.g. print the credit or re-generate the XML content.
Of course, the IHospitalRequestRequest::Initalize method should NOT be called under these circumstances. Of course, the data of one main sponsor does not allow to re-generate XML streams for the other sponsors!

hospitalCreditRequest
  IHospitalCreditRequestManager
    GetHospitalCreditRequest

C/C++ syntax
HRESULT  GetHospitalCreditRequest( LanguageType   eLanguage,
BSTR   bstrSoftwarePackage,
long   lSoftwareVersion,
long   lSoftwareID,
IHospitalCreditRequest   **ppIHospitalCreditRequest);

Parameter description
[in]   LanguageType   eLanguage   Language type
[in]   BSTR   bstrSoftwarePackage   Name of the main software using this DLL.

New feature: if the variable holds either

  • a XML content coded in UNICODE
  • an accessible full path to an XML file
the supplied XML data is loaded into the IHospitalCreditRequest interface. See description of lSoftwareVersion as well.
BEWARE: the XML content must be well-formed, valid and of version V4.1 otherwise an error is generated.
[in]   long   lSoftwareVersion   Version of the main software using this DLL.

New feature: if the variable bstrSoftwarePackage is used to load external XML data then lSoftwareVersion is used to control the timestamp and resend status.

  • lSoftwareVersion=0: use the XML supplied timestamp and resend status. This is the default if none of the defined values apply
  • lSoftwareVersion=1: use the XML supplied timestamp and set the resend status to original (resendID=0)
  • lSoftwareVersion=2: use the XML supplied timestamp and set the resend status to copy (resendID=1)
[in]   long   lSoftwareID   Identification number of the main software using this DLL
[out, retval]   IHospitalCreditRequest   **ppIHospitalCreditRequest   IHospitalCreditRequest interface handle. The handle is NULL if an error occurred.

C/C++ return value
S_OK This value is returned if the function call was successful or if the return value of a boolean method signalling a true value. In this case the VARIANT_BOOL is set to VARIANT_TRUE.
S_FALSE This is the return value of a boolean method signalling a false return value. In this case the VARIANT_BOOL is set to VARIANT_FALSE.
E_name This value is returned if the function call was unsuccessful and an error exception was generated. Note that if you are using SmartPointers an exception is thrown under these conditions.