4 endpoint mapper interface
6 http://www.opengroup.org/onlinepubs/9629399/apdxl.htm : Details on towers
7 http://www.opengroup.org/onlinepubs/9629399/chap6.htm#tagcjh_11_02_03_01: binding strings
12 uuid("e1af8308-5d1f-11c9-91a4-08002b14a0fa"),
14 endpoint("ncacn_np:[\\pipe\\epmapper]", "ncacn_ip_tcp:[135]",
15 "ncalrpc:[EPMAPPER]"),
16 helpstring("EndPoint Mapper"),
23 note that the following IDL won't work in MIDL, and in fact
24 that the full towers/floors representation of epm cannot be
25 represented in MIDL at all. I decided to represent it using
26 the extended IDL syntax in pidl to make it easier to work
30 const int EPMAPPER_STATUS_NO_MORE_ENTRIES
= 0x16c9a0d6;
31 const int EPMAPPER_STATUS_NO_MEMORY
= 0x16C9A012;
32 const int EPMAPPER_STATUS_OK
= 0;
36 typedef [enum8bit
] enum {
38 /* Level 4 and higher */
39 EPM_PROTOCOL_DNET_NSP
= 0x04,
40 EPM_PROTOCOL_OSI_TP4
= 0x05,
41 EPM_PROTOCOL_OSI_CLNS
= 0x06,
42 EPM_PROTOCOL_TCP
= 0x07,
43 EPM_PROTOCOL_UDP
= 0x08,
44 EPM_PROTOCOL_IP
= 0x09,
45 /* These 4 are protocol identifiers, always at level 3 or lower */
46 EPM_PROTOCOL_NCADG
= 0x0a, /* Connectionless RPC */
47 EPM_PROTOCOL_NCACN
= 0x0b,
48 EPM_PROTOCOL_NCALRPC
= 0x0c, /* Local RPC */
49 EPM_PROTOCOL_UUID
= 0x0d,
50 EPM_PROTOCOL_IPX
= 0x0e,
51 EPM_PROTOCOL_SMB
= 0x0f,
52 EPM_PROTOCOL_PIPE
= 0x10,
53 EPM_PROTOCOL_NETBIOS
= 0x11,
54 EPM_PROTOCOL_NETBEUI
= 0x12,
55 EPM_PROTOCOL_SPX
= 0x13,
56 EPM_PROTOCOL_NB_IPX
= 0x14, /* NetBIOS over IPX */
57 EPM_PROTOCOL_DSP
= 0x16, /* AppleTalk Data Stream Protocol */
58 EPM_PROTOCOL_DDP
= 0x17, /* AppleTalk Data Datagram Protocol */
59 EPM_PROTOCOL_APPLETALK
= 0x18, /* AppleTalk */
60 EPM_PROTOCOL_VINES_SPP
= 0x1a,
61 EPM_PROTOCOL_VINES_IPC
= 0x1b, /* Inter Process Communication */
62 EPM_PROTOCOL_STREETTALK
= 0x1c, /* Vines Streettalk */
63 EPM_PROTOCOL_HTTP
= 0x1f,
64 EPM_PROTOCOL_UNIX_DS
= 0x20, /* Unix domain socket */
65 EPM_PROTOCOL_NULL
= 0x21
101 [flag
(NDR_REMAINING
)] DATA_BLOB unknown
;
141 uint16 minor_version
;
148 } epm_rhs_atalk_stream
;
151 } epm_rhs_atalk_datagram
;
163 } epm_rhs_streettalk
;
165 typedef [flag
(NDR_BIG_ENDIAN
),nodiscriminant
] union {
166 [case(EPM_PROTOCOL_DNET_NSP
)] epm_rhs_dnet_nsp dnet_nsp
;
167 [case(EPM_PROTOCOL_OSI_TP4
)] epm_rhs_osi_tp4 osi_tp4
;
168 [case(EPM_PROTOCOL_OSI_CLNS
)] epm_rhs_osi_clns osi_clns
;
169 [case(EPM_PROTOCOL_TCP
)] epm_rhs_tcp tcp
;
170 [case(EPM_PROTOCOL_UDP
)] epm_rhs_udp udp
;
171 [case(EPM_PROTOCOL_IP
)] epm_rhs_ip ip
;
172 [case(EPM_PROTOCOL_NCADG
)] epm_rhs_ncadg ncadg
;
173 [case(EPM_PROTOCOL_NCACN
)] epm_rhs_ncacn ncacn
;
174 [case(EPM_PROTOCOL_NCALRPC
)] epm_rhs_ncalrpc ncalrpc
;
175 [case(EPM_PROTOCOL_UUID
)] epm_rhs_uuid
uuid;
176 [case(EPM_PROTOCOL_IPX
)] epm_rhs_ipx ipx
;
177 [case(EPM_PROTOCOL_SMB
)] epm_rhs_smb smb
;
178 [case(EPM_PROTOCOL_PIPE
)] epm_rhs_pipe
pipe;
179 [case(EPM_PROTOCOL_NETBIOS
)] epm_rhs_netbios netbios
;
180 [case(EPM_PROTOCOL_NETBEUI
)] epm_rhs_netbeui netbeui
;
181 [case(EPM_PROTOCOL_SPX
)] epm_rhs_spx spx
;
182 [case(EPM_PROTOCOL_NB_IPX
)] epm_rhs_nb_ipx nb_ipx
;
183 [case(EPM_PROTOCOL_DSP
)] epm_rhs_atalk_stream atalk_stream
;
184 [case(EPM_PROTOCOL_DDP
)] epm_rhs_atalk_datagram atalk_datagram
;
185 [case(EPM_PROTOCOL_APPLETALK
)] epm_rhs_appletalk appletalk
;
186 [case(EPM_PROTOCOL_VINES_SPP
)] epm_rhs_vines_spp vines_spp
;
187 [case(EPM_PROTOCOL_VINES_IPC
)] epm_rhs_vines_ipc vines_ipc
;
188 [case(EPM_PROTOCOL_STREETTALK
)] epm_rhs_streettalk streettalk
;
189 [case(EPM_PROTOCOL_HTTP
)] epm_rhs_http http
;
190 [case(EPM_PROTOCOL_UNIX_DS
)] epm_rhs_unix_ds unix_ds
;
191 [case(EPM_PROTOCOL_NULL
)] epm_rhs_null null
;
192 [default] [flag
(NDR_REMAINING
)] DATA_BLOB unknown
;
196 epm_protocol protocol
;
197 [flag
(NDR_REMAINING
)] DATA_BLOB lhs_data
;
201 [subcontext
(2)] epm_lhs lhs
;
202 [subcontext
(2),switch_is(lhs.protocol
)] epm_rhs rhs
;
205 /* note that the NDR_NOALIGN flag is inherited by all nested
206 structures. All of the towers/floors stuff is
207 non-aligned. I wonder what sort of wicked substance these
210 typedef [gensize
,flag
(NDR_NOALIGN|NDR_LITTLE_ENDIAN
)] struct {
212 epm_floor floors
[num_floors
];
216 [value
(ndr_size_epm_tower
(&tower
, ndr
->flags
))] uint32 tower_length
;
217 [subcontext
(4)] epm_tower tower
;
232 /**********************/
234 error_status_t epm_Insert
(
235 [in] uint32 num_ents
,
236 [in,size_is(num_ents
)] epm_entry_t entries
[],
240 /**********************/
242 error_status_t epm_Delete
(
243 [in] uint32 num_ents
,
244 [in, size_is(num_ents
)] epm_entry_t entries
[]
247 /**********************/
249 error_status_t epm_Lookup
(
250 [in] uint32 inquiry_type
,
251 [in,ptr] GUID
*object,
252 [in,ptr] rpc_if_id_t
*interface_id
,
253 [in] uint32 vers_option
,
254 [in,out] policy_handle
*entry_handle
,
255 [in] uint32 max_ents
,
256 [out] uint32
*num_ents
,
257 [out, length_is(*num_ents
), size_is(max_ents
)] epm_entry_t entries
[]
261 /**********************/
268 [public] error_status_t epm_Map
(
269 [in,ptr] GUID
*object,
270 [in,ptr] epm_twr_t
*map_tower
,
271 [in,out] policy_handle
*entry_handle
,
272 [in] uint32 max_towers
,
273 [out] uint32
*num_towers
,
274 [out, length_is(*num_towers
), size_is(max_towers
)] epm_twr_p_t towers
[]
278 /**********************/
280 error_status_t epm_LookupHandleFree
(
281 [in,out] policy_handle
*entry_handle
284 /**********************/
286 error_status_t epm_InqObject
(
287 [in] GUID
*epm_object
291 /**********************/
293 error_status_t epm_MgmtDelete
(
294 [in] uint32 object_speced
,
295 [in,ptr] GUID
*object,
296 [in,ptr] epm_twr_t
*tower
299 /**********************/
301 error_status_t epm_MapAuth
();