SkDCOMbridge : COM/DCOM Handler Object

Method Descriptions and Definitions

• Main function : getInterfacePointer

  Prototype

  int getInterfacePointer(IUnknown **ppInterface,
                          void *comObjectInfo,
                          void *interfaceObjectInfo,
                          int flags = SKDCOM_COMINFO_NAME 
                                    | SKDCOM_INTERFACEINFO_NAME,
                          void *computerName = NULL,
                          COAUTHINFO *pAuthInfo = NULL);
  

  Parameters

  ppInterface	[out]	Pointer for interface pointer in which the method should enter the desired interface's pointer.
  comObjectInfo	[in]	COM object's description. can be name [OLE string !] or CLSID.
  interfaceObjectInfo	[in]	Interface's description. can be name [OLE string] or IID.
  flags	[in]	flags which describes 'comObjectInfo' and 'interfaceObjectInfo' use SKDCOM_COMINFO_NAME - when 'comObjectInfo' is object's a name (such as 'MyCOM.Engine') SKDCOM_COMINFO_CLASID - when 'comObjectInfo' is object's an CLSID. SKDCOM_INTERFACEINFO_NAME - when 'interfaceObjectInfo' is a name (such as 'MyCOM.Engine.iXYZ') SKDCOM_INTERFACEINFO_REFIID - when 'interfaceObjectInfo' is an IID each flag value should be a logical or of 'comObjectInfo' and 'interfaceObjectInfo' descriptions. default value is name for both.
  computerName	[in]	points to a computer name. DCOM ONLY. if NULL object uses COM.
  pAuthInfo	[in]	points to a 'COAUTHINFO' object. DCOM ONLY. if NULL object uses default security parameters.

  Remarks

• GetCLSID Function

  Prototype

  void getCLSID(CLSID *clsid) const;
  

  Parameters

  clsid

  [out]

  Pointer to a CLSID instance which will recieve object's CLSID value.

  Remarks

  Retrieves object's CLSID (even if main method was called with name for object's description)

  Return Value

  • SKDCOM_ERROR_CLSID_NAME_NOT_FOUND - object's name was not found.
  • SKDCOM_ERROR_CLSID_NOT_FOUND - object's ID was not found.
  • SKDCOM_ERROR_IID_NOT_FOUND - interface's ID was not found.
  • SKDCOM_ERROR_IID_NAME_NOT_FOUND - interface's name was not found.
  • SKDCOM_ERROR_FAIL - function failed.
  • SKDCOM_SUCCESS - success. output parameter is valid.

• getIID Function

  Prototype

  void getIID(IID *iid) const;
  

  Parameters

  iid

  [out]

  Pointer to an IID instance which recieve interface's IID value.

  Remarks

  Retrieves interface's IID (even if main method was called with name for interface description)

• getLastRetrivedInterface Function

  Prototype

  void getLastRetrivedInterface(IUnknown **ppInterface) const;
  

  Parameters

  ppInterface

  [out]

  Points to an interface pointer

  Remarks

  Enters last retrived pointer to 'ppInterface'.

• getLastSystemError

  Prototype

  HRESULT getLastSystemError() const;
  

  Parameters

  No parameters

  Return Value

  Returns system last error (Window's API error code).

Downloads

History