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 #if 0
  20 #pragma makedep install
  21 #endif
  22
  23 [
  24     object,
  25     uuid(0c733a8c-2a1c-11ce-ade5-00aa0044773d),
  26     pointer_default(unique)
  27 ]
  28 interface IAccessor : IUnknown
  29 {
  30
  31     typedef DWORD DBACCESSORFLAGS;
  32
  33     typedef DWORD DBBINDSTATUS;
  34
  35     [local]
  36     HRESULT AddRefAccessor([in] HACCESSOR hAccessor,
  37                            [in, out, unique, annotation("__out_opt")] DBREFCOUNT *pcRefCount);
  38
  39     [call_as(AddRefAccessor)]
  40     HRESULT RemoteAddRefAccessor([in] HACCESSOR hAccessor,
  41                                  [in, out, unique] DBREFCOUNT *pcRefCount,
  42                                  [out] IErrorInfo **ppErrorInfoRem);
  43
  44     [local]
  45     HRESULT CreateAccessor([in] DBACCESSORFLAGS dwAccessorFlags,
  46                            [in] DBCOUNTITEM cBindings,
  47                            [in, size_is(cBindings), annotation("__in_ecount(cBindings)")] const DBBINDING rgBindings[],
  48                            [in] DBLENGTH cbRowSize,
  49                            [out, annotation("__out")] HACCESSOR *phAccessor,
  50                            [out, size_is(cBindings), annotation("__out_ecount_opt(cBindings)")] DBBINDSTATUS rgStatus[]);
  51
  52     [call_as(CreateAccessor)]
  53     HRESULT RemoteCreateAccessor([in] DBACCESSORFLAGS dwAccessorFlags,
  54                                  [in] DBCOUNTITEM cBindings,
  55                                  [in, unique, size_is((ULONG)cBindings)] DBBINDING *rgBindings,
  56                                  [in] DBLENGTH cbRowSize,
  57                                  [out] HACCESSOR *phAccessor,
  58                                  [in, out, unique, size_is((ULONG)cBindings)] DBBINDSTATUS *rgStatus,
  59                                  [out] IErrorInfo **ppErrorInfoRem);
  60
  61     [local]
  62     HRESULT GetBindings([in] HACCESSOR hAccessor,
  63                         [out, annotation("__out")] DBACCESSORFLAGS *pdwAccessorFlags,
  64                         [in, out, annotation("__out_opt")] DBCOUNTITEM *pcBindings,
  65                         [out, size_is(,*pcBindings), annotation("__deref_out_ecount_opt(*pcBindings)")] DBBINDING **prgBindings);
  66
  67     [call_as(GetBindings)]
  68     HRESULT RemoteGetBindings([in] HACCESSOR hAccessor,
  69                               [out] DBACCESSORFLAGS *pdwAccessorFlags,
  70                               [in, out] DBCOUNTITEM *pcBindings,
  71                               [out, size_is(,(ULONG)*pcBindings)] DBBINDING **prgBindings,
  72                               [out] IErrorInfo **ppErrorInfoRem);
  73
  74     [local]
  75     HRESULT ReleaseAccessor([in] HACCESSOR hAccessor,
  76                             [in, out, unique, annotation("__out_opt")] DBREFCOUNT *pcRefCount);
  77
  78     [call_as(ReleaseAccessor)]
  79     HRESULT RemoteReleaseAccessor([in] HACCESSOR hAccessor,
  80                                   [in, out, unique] DBREFCOUNT *pcRefCount,
  81                                   [out] IErrorInfo **ppErrorInfoRem);
  82
  83 }