dlls/rpcrt4/rpc_binding.h

   1 /*
   2  * RPC binding API
   3  *
   4  * Copyright 2001 Ove Kåven, TransGaming Technologies
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #ifndef __WINE_RPC_BINDING_H
  22 #define __WINE_RPC_BINDING_H
  23
  24 #include "wine/rpcss_shared.h"
  25 #include "security.h"
  26 #include "wine/list.h"
  27
  28
  29 typedef struct _RpcAuthInfo
  30 {
  31   LONG refs;
  32
  33   ULONG AuthnLevel;
  34   ULONG AuthnSvc;
  35   CredHandle cred;
  36   TimeStamp exp;
  37   ULONG cbMaxToken;
  38   /* the auth identity pointer that the application passed us (freed by application) */
  39   RPC_AUTH_IDENTITY_HANDLE *identity;
  40   /* our copy of NT auth identity structure, if the authentication service
  41    * takes an NT auth identity */
  42   SEC_WINNT_AUTH_IDENTITY_W *nt_identity;
  43 } RpcAuthInfo;
  44
  45 typedef struct _RpcQualityOfService
  46 {
  47     LONG refs;
  48
  49     RPC_SECURITY_QOS_V2_W *qos;
  50 } RpcQualityOfService;
  51
  52 typedef struct _RpcAssoc
  53 {
  54     struct list entry; /* entry in the global list of associations */
  55     LONG refs;
  56
  57     LPSTR Protseq;
  58     LPSTR NetworkAddr;
  59     LPSTR Endpoint;
  60     LPWSTR NetworkOptions;
  61
  62     /* id of this association group */
  63     ULONG assoc_group_id;
  64
  65     CRITICAL_SECTION cs;
  66     struct list connection_pool;
  67 } RpcAssoc;
  68
  69 struct connection_ops;
  70
  71 typedef struct _RpcConnection
  72 {
  73   struct _RpcConnection* Next;
  74   BOOL server;
  75   LPSTR NetworkAddr;
  76   LPSTR Endpoint;
  77   LPWSTR NetworkOptions;
  78   const struct connection_ops *ops;
  79   USHORT MaxTransmissionSize;
  80   /* The active interface bound to server. */
  81   RPC_SYNTAX_IDENTIFIER ActiveInterface;
  82   USHORT NextCallId;
  83
  84   /* authentication */
  85   CtxtHandle ctx;
  86   TimeStamp exp;
  87   ULONG attr;
  88   RpcAuthInfo *AuthInfo;
  89   ULONG encryption_auth_len;
  90   ULONG signature_auth_len;
  91   RpcQualityOfService *QOS;
  92
  93   /* client-only */
  94   struct list conn_pool_entry;
  95   ULONG assoc_group_id; /* association group returned during binding */
  96 } RpcConnection;
  97
  98 struct connection_ops {
  99   const char *name;
 100   unsigned char epm_protocols[2]; /* only floors 3 and 4. see http://www.opengroup.org/onlinepubs/9629399/apdxl.htm */
 101   RpcConnection *(*alloc)(void);
 102   RPC_STATUS (*open_connection_client)(RpcConnection *conn);
 103   RPC_STATUS (*handoff)(RpcConnection *old_conn, RpcConnection *new_conn);
 104   int (*read)(RpcConnection *conn, void *buffer, unsigned int len);
 105   int (*write)(RpcConnection *conn, const void *buffer, unsigned int len);
 106   int (*close)(RpcConnection *conn);
 107   size_t (*get_top_of_tower)(unsigned char *tower_data, const char *networkaddr, const char *endpoint);
 108   RPC_STATUS (*parse_top_of_tower)(const unsigned char *tower_data, size_t tower_size, char **networkaddr, char **endpoint);
 109 };
 110
 111 /* don't know what MS's structure looks like */
 112 typedef struct _RpcBinding
 113 {
 114   LONG refs;
 115   struct _RpcBinding* Next;
 116   BOOL server;
 117   UUID ObjectUuid;
 118   LPSTR Protseq;
 119   LPSTR NetworkAddr;
 120   LPSTR Endpoint;
 121   LPWSTR NetworkOptions;
 122   RPC_BLOCKING_FN BlockingFn;
 123   ULONG ServerTid;
 124   RpcConnection* FromConn;
 125   RpcAssoc *Assoc;
 126
 127   /* authentication */
 128   RpcAuthInfo *AuthInfo;
 129   RpcQualityOfService *QOS;
 130 } RpcBinding;
 131
 132 LPSTR RPCRT4_strndupA(LPCSTR src, INT len);
 133 LPWSTR RPCRT4_strndupW(LPCWSTR src, INT len);
 134 LPSTR RPCRT4_strdupWtoA(LPCWSTR src);
 135 LPWSTR RPCRT4_strdupAtoW(LPCSTR src);
 136 void RPCRT4_strfree(LPSTR src);
 137
 138 #define RPCRT4_strdupA(x) RPCRT4_strndupA((x),-1)
 139 #define RPCRT4_strdupW(x) RPCRT4_strndupW((x),-1)
 140
 141 ULONG RpcAuthInfo_AddRef(RpcAuthInfo *AuthInfo);
 142 ULONG RpcAuthInfo_Release(RpcAuthInfo *AuthInfo);
 143 BOOL RpcAuthInfo_IsEqual(const RpcAuthInfo *AuthInfo1, const RpcAuthInfo *AuthInfo2);
 144 ULONG RpcQualityOfService_AddRef(RpcQualityOfService *qos);
 145 ULONG RpcQualityOfService_Release(RpcQualityOfService *qos);
 146 BOOL RpcQualityOfService_IsEqual(const RpcQualityOfService *qos1, const RpcQualityOfService *qos2);
 147
 148 RPC_STATUS RPCRT4_GetAssociation(LPCSTR Protseq, LPCSTR NetworkAddr, LPCSTR Endpoint, LPCWSTR NetworkOptions, RpcAssoc **assoc);
 149 RpcConnection *RpcAssoc_GetIdleConnection(RpcAssoc *assoc, const RPC_SYNTAX_IDENTIFIER *InterfaceId, const RPC_SYNTAX_IDENTIFIER *TransferSyntax, const RpcAuthInfo *AuthInfo, const RpcQualityOfService *QOS);
 150 void RpcAssoc_ReleaseIdleConnection(RpcAssoc *assoc, RpcConnection *Connection);
 151 ULONG RpcAssoc_Release(RpcAssoc *assoc);
 152
 153 RPC_STATUS RPCRT4_CreateConnection(RpcConnection** Connection, BOOL server, LPCSTR Protseq, LPCSTR NetworkAddr, LPCSTR Endpoint, LPCWSTR NetworkOptions, RpcAuthInfo* AuthInfo, RpcQualityOfService *QOS);
 154 RPC_STATUS RPCRT4_DestroyConnection(RpcConnection* Connection);
 155 RPC_STATUS RPCRT4_OpenClientConnection(RpcConnection* Connection);
 156 RPC_STATUS RPCRT4_CloseConnection(RpcConnection* Connection);
 157 RPC_STATUS RPCRT4_SpawnConnection(RpcConnection** Connection, RpcConnection* OldConnection);
 158
 159 RPC_STATUS RPCRT4_ResolveBinding(RpcBinding* Binding, LPCSTR Endpoint);
 160 RPC_STATUS RPCRT4_SetBindingObject(RpcBinding* Binding, const UUID* ObjectUuid);
 161 RPC_STATUS RPCRT4_MakeBinding(RpcBinding** Binding, RpcConnection* Connection);
 162 RPC_STATUS RPCRT4_ExportBinding(RpcBinding** Binding, RpcBinding* OldBinding);
 163 RPC_STATUS RPCRT4_DestroyBinding(RpcBinding* Binding);
 164 RPC_STATUS RPCRT4_OpenBinding(RpcBinding* Binding, RpcConnection** Connection, PRPC_SYNTAX_IDENTIFIER TransferSyntax, PRPC_SYNTAX_IDENTIFIER InterfaceId);
 165 RPC_STATUS RPCRT4_CloseBinding(RpcBinding* Binding, RpcConnection* Connection);
 166 BOOL RPCRT4_RPCSSOnDemandCall(PRPCSS_NP_MESSAGE msg, char *vardata_payload, PRPCSS_NP_REPLY reply);
 167 HANDLE RPCRT4_GetMasterMutex(void);
 168 HANDLE RPCRT4_RpcssNPConnect(void);
 169
 170 static inline const char *rpcrt4_conn_get_name(RpcConnection *Connection)
 171 {
 172   return Connection->ops->name;
 173 }
 174
 175 static inline int rpcrt4_conn_read(RpcConnection *Connection,
 176                      void *buffer, unsigned int len)
 177 {
 178   return Connection->ops->read(Connection, buffer, len);
 179 }
 180
 181 static inline int rpcrt4_conn_write(RpcConnection *Connection,
 182                      const void *buffer, unsigned int len)
 183 {
 184   return Connection->ops->write(Connection, buffer, len);
 185 }
 186
 187 static inline int rpcrt4_conn_close(RpcConnection *Connection)
 188 {
 189   return Connection->ops->close(Connection);
 190 }
 191
 192 static inline RPC_STATUS rpcrt4_conn_handoff(RpcConnection *old_conn, RpcConnection *new_conn)
 193 {
 194   return old_conn->ops->handoff(old_conn, new_conn);
 195 }
 196
 197 /* floors 3 and up */
 198 RPC_STATUS RpcTransport_GetTopOfTower(unsigned char *tower_data, size_t *tower_size, const char *protseq, const char *networkaddr, const char *endpoint);
 199 RPC_STATUS RpcTransport_ParseTopOfTower(const unsigned char *tower_data, size_t tower_size, char **protseq, char **networkaddr, char **endpoint);
 200
 201 #endif