include/access.idl

   1 /*
   2  * Copyright (C) 2009 Huw Davies
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 [
  20     object,
  21     uuid(0c733a8c-2a1c-11ce-ade5-00aa0044773d),
  22     pointer_default(unique)
  23 ]
  24 interface IAccessor : IUnknown
  25 {
  26
  27     typedef DWORD DBACCESSORFLAGS;
  28
  29     typedef DWORD DBBINDSTATUS;
  30
  31     [local]
  32     HRESULT AddRefAccessor([in] HACCESSOR hAccessor,
  33                            [in, out, unique, annotation("__out_opt")] DBREFCOUNT *pcRefCount);
  34
  35     [call_as(AddRefAccessor)]
  36     HRESULT RemoteAddRefAccessor([in] HACCESSOR hAccessor,
  37                                  [in, out, unique, annotation("__out_opt")] DBREFCOUNT *pcRefCount,
  38                                  [out] IErrorInfo **ppErrorInfoRem);
  39
  40     [local]
  41     HRESULT CreateAccessor([in] DBACCESSORFLAGS dwAccessorFlags,
  42                            [in] DBCOUNTITEM cBindings,
  43                            [in, size_is(cBindings), annotation("__in_ecount(cBindings)")] const DBBINDING rgBindings[],
  44                            [in] DBLENGTH cbRowSize,
  45                            [out, annotation("__out")] HACCESSOR *phAccessor,
  46                            [out, size_is(cBindings), annotation("__out_ecount_opt(cBindings)")] DBBINDSTATUS rgStatus[]);
  47
  48     [call_as(CreateAccessor)]
  49     HRESULT RemoteCreateAccessor([in] DBACCESSORFLAGS dwAccessorFlags,
  50                                  [in] DBCOUNTITEM cBindings,
  51                                  [in, unique, size_is((ULONG)cBindings)] DBBINDING *rgBindings,
  52                                  [in] DBLENGTH cbRowSize,
  53                                  [out] HACCESSOR *phAccessor,
  54                                  [in, out, unique, size_is((ULONG)cBindings)] DBBINDSTATUS *rgStatus,
  55                                  [out] IErrorInfo **ppErrorInfoRem);
  56
  57     [local]
  58     HRESULT GetBindings([in] HACCESSOR hAccessor,
  59                         [out, annotation("__out")] DBACCESSORFLAGS *pdwAccessorFlags,
  60                         [in, out, annotation("__out_opt")] DBCOUNTITEM *pcBindings,
  61                         [out, size_is(,*pcBindings), annotation("__deref_out_ecount_opt(*pcBindings)")] DBBINDING **prgBindings);
  62
  63     [call_as(GetBindings)]
  64     HRESULT RemoteGetBindings([in] HACCESSOR hAccessor,
  65                               [out] DBACCESSORFLAGS *pdwAccessorFlags,
  66                               [in, out] DBCOUNTITEM *pcBindings,
  67                               [out, size_is(,(ULONG)*pcBindings)] DBBINDING **prgBindings,
  68                               [out] IErrorInfo **ppErrorInfoRem);
  69
  70     [local]
  71     HRESULT ReleaseAccessor([in] HACCESSOR hAccessor,
  72                             [in, out, unique, annotation("__out_opt")] DBREFCOUNT *pcRefCount);
  73
  74     [call_as(ReleaseAccessor)]
  75     HRESULT RemoteReleaseAccessor([in] HACCESSOR hAccessor,
  76                                   [in, out, unique] DBREFCOUNT *pcRefCount,
  77                                   [out] IErrorInfo **ppErrorInfoRem);
  78
  79 };