ole32: Clarify the timestamp fields in StgProperty.
[wine] / dlls / jscript / function.c
1 /*
2  * Copyright 2008 Jacek Caban for CodeWeavers
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 #include "jscript.h"
20 #include "engine.h"
21
22 #include "wine/debug.h"
23
24 WINE_DEFAULT_DEBUG_CHANNEL(jscript);
25
26 typedef struct {
27     DispatchEx dispex;
28     builtin_invoke_t value_proc;
29     const WCHAR *name;
30     DWORD flags;
31     source_elements_t *source;
32     parameter_t *parameters;
33     scope_chain_t *scope_chain;
34     parser_ctx_t *parser;
35     const WCHAR *src_str;
36     DWORD src_len;
37     DWORD length;
38 } FunctionInstance;
39
40 static inline FunctionInstance *function_from_vdisp(vdisp_t *vdisp)
41 {
42     return (FunctionInstance*)vdisp->u.jsdisp;
43 }
44
45 static inline FunctionInstance *function_this(vdisp_t *jsthis)
46 {
47     return is_vclass(jsthis, JSCLASS_FUNCTION) ? function_from_vdisp(jsthis) : NULL;
48 }
49
50 static const WCHAR prototypeW[] = {'p','r','o','t','o','t', 'y', 'p','e',0};
51
52 static const WCHAR lengthW[] = {'l','e','n','g','t','h',0};
53 static const WCHAR toStringW[] = {'t','o','S','t','r','i','n','g',0};
54 static const WCHAR applyW[] = {'a','p','p','l','y',0};
55 static const WCHAR callW[] = {'c','a','l','l',0};
56
57 static IDispatch *get_this(DISPPARAMS *dp)
58 {
59     DWORD i;
60
61     for(i=0; i < dp->cNamedArgs; i++) {
62         if(dp->rgdispidNamedArgs[i] == DISPID_THIS) {
63             if(V_VT(dp->rgvarg+i) == VT_DISPATCH)
64                 return V_DISPATCH(dp->rgvarg+i);
65
66             WARN("This is not VT_DISPATCH\n");
67             return NULL;
68         }
69     }
70
71     TRACE("no this passed\n");
72     return NULL;
73 }
74
75 static HRESULT init_parameters(DispatchEx *var_disp, FunctionInstance *function, DISPPARAMS *dp,
76         jsexcept_t *ei, IServiceProvider *caller)
77 {
78     parameter_t *param;
79     VARIANT var_empty;
80     DWORD cargs, i=0;
81     HRESULT hres;
82
83     V_VT(&var_empty) = VT_EMPTY;
84     cargs = arg_cnt(dp);
85
86     for(param = function->parameters; param; param = param->next) {
87         hres = jsdisp_propput_name(var_disp, param->identifier,
88                 i < cargs ? get_arg(dp,i) : &var_empty, ei, caller);
89         if(FAILED(hres))
90             return hres;
91
92         i++;
93     }
94
95     return S_OK;
96 }
97
98 static HRESULT Arguments_value(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
99         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
100 {
101     FIXME("\n");
102     return E_NOTIMPL;
103 }
104
105 static const builtin_info_t Arguments_info = {
106     JSCLASS_ARGUMENTS,
107     {NULL, Arguments_value, 0},
108     0, NULL,
109     NULL,
110     NULL
111 };
112
113 static HRESULT create_arguments(script_ctx_t *ctx, IDispatch *calee, DISPPARAMS *dp,
114         jsexcept_t *ei, IServiceProvider *caller, DispatchEx **ret)
115 {
116     DispatchEx *args;
117     VARIANT var;
118     DWORD i;
119     HRESULT hres;
120
121     static const WCHAR caleeW[] = {'c','a','l','l','e','e',0};
122
123     args = heap_alloc_zero(sizeof(DispatchEx));
124     if(!args)
125         return E_OUTOFMEMORY;
126
127     hres = init_dispex_from_constr(args, ctx, &Arguments_info, ctx->object_constr);
128     if(FAILED(hres)) {
129         heap_free(args);
130         return hres;
131     }
132
133     for(i=0; i < arg_cnt(dp); i++) {
134         hres = jsdisp_propput_idx(args, i, get_arg(dp,i), ei, caller);
135         if(FAILED(hres))
136             break;
137     }
138
139     if(SUCCEEDED(hres)) {
140         V_VT(&var) = VT_I4;
141         V_I4(&var) = arg_cnt(dp);
142         hres = jsdisp_propput_name(args, lengthW, &var, ei, caller);
143
144         if(SUCCEEDED(hres)) {
145             V_VT(&var) = VT_DISPATCH;
146             V_DISPATCH(&var) = calee;
147             hres = jsdisp_propput_name(args, caleeW, &var, ei, caller);
148         }
149     }
150
151     if(FAILED(hres)) {
152         jsdisp_release(args);
153         return hres;
154     }
155
156     *ret = args;
157     return S_OK;
158 }
159
160 static HRESULT create_var_disp(script_ctx_t *ctx, FunctionInstance *function, DISPPARAMS *dp, jsexcept_t *ei,
161                                IServiceProvider *caller, DispatchEx **ret)
162 {
163     DispatchEx *var_disp, *arg_disp;
164     HRESULT hres;
165
166     static const WCHAR argumentsW[] = {'a','r','g','u','m','e','n','t','s',0};
167
168     hres = create_dispex(ctx, NULL, NULL, &var_disp);
169     if(FAILED(hres))
170         return hres;
171
172     hres = create_arguments(ctx, (IDispatch*)_IDispatchEx_(&function->dispex),
173             dp, ei, caller, &arg_disp);
174     if(SUCCEEDED(hres)) {
175         VARIANT var;
176
177         V_VT(&var) = VT_DISPATCH;
178         V_DISPATCH(&var) = (IDispatch*)_IDispatchEx_(arg_disp);
179         hres = jsdisp_propput_name(var_disp, argumentsW, &var, ei, caller);
180         jsdisp_release(arg_disp);
181     }
182
183     if(SUCCEEDED(hres))
184         hres = init_parameters(var_disp, function, dp, ei, caller);
185     if(FAILED(hres)) {
186         jsdisp_release(var_disp);
187         return hres;
188     }
189
190     *ret = var_disp;
191     return S_OK;
192 }
193
194 static HRESULT invoke_source(script_ctx_t *ctx, FunctionInstance *function, IDispatch *this_obj, DISPPARAMS *dp,
195         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
196 {
197     DispatchEx *var_disp;
198     exec_ctx_t *exec_ctx;
199     scope_chain_t *scope;
200     HRESULT hres;
201
202     if(!function->source) {
203         FIXME("no source\n");
204         return E_FAIL;
205     }
206
207     hres = create_var_disp(ctx, function, dp, ei, caller, &var_disp);
208     if(FAILED(hres))
209         return hres;
210
211     hres = scope_push(function->scope_chain, var_disp, &scope);
212     if(SUCCEEDED(hres)) {
213         hres = create_exec_ctx(ctx, this_obj, var_disp, scope, &exec_ctx);
214         scope_release(scope);
215     }
216     if(FAILED(hres))
217         return hres;
218
219     hres = exec_source(exec_ctx, function->parser, function->source, ei, retv);
220     exec_release(exec_ctx);
221
222     return hres;
223 }
224
225 static HRESULT invoke_constructor(script_ctx_t *ctx, FunctionInstance *function, DISPPARAMS *dp,
226         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
227 {
228     DispatchEx *this_obj;
229     VARIANT var;
230     HRESULT hres;
231
232     hres = create_object(ctx, &function->dispex, &this_obj);
233     if(FAILED(hres))
234         return hres;
235
236     hres = invoke_source(ctx, function, (IDispatch*)_IDispatchEx_(this_obj), dp, &var, ei, caller);
237     if(FAILED(hres)) {
238         jsdisp_release(this_obj);
239         return hres;
240     }
241
242     V_VT(retv) = VT_DISPATCH;
243     if(V_VT(&var) == VT_DISPATCH) {
244         jsdisp_release(this_obj);
245         V_DISPATCH(retv) = V_DISPATCH(&var);
246     }else {
247         VariantClear(&var);
248         V_DISPATCH(retv) = (IDispatch*)_IDispatchEx_(this_obj);
249     }
250     return S_OK;
251 }
252
253 static HRESULT invoke_value_proc(script_ctx_t *ctx, FunctionInstance *function, IDispatch *this_disp, WORD flags, DISPPARAMS *dp,
254         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
255 {
256     vdisp_t vthis;
257     HRESULT hres;
258
259     if(this_disp)
260         set_disp(&vthis, this_disp);
261     else if(ctx->host_global)
262         set_disp(&vthis, ctx->host_global);
263     else
264         set_jsdisp(&vthis, ctx->global);
265
266     hres = function->value_proc(ctx, &vthis, flags, dp, retv, ei, caller);
267
268     vdisp_release(&vthis);
269     return hres;
270 }
271
272 static HRESULT call_function(script_ctx_t *ctx, FunctionInstance *function, IDispatch *this_obj, DISPPARAMS *args,
273         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
274 {
275     if(function->value_proc)
276         return invoke_value_proc(ctx, function, this_obj, DISPATCH_METHOD, args, retv, ei, caller);
277
278     return invoke_source(ctx, function, this_obj, args, retv, ei, caller);
279 }
280
281 static HRESULT function_to_string(FunctionInstance *function, BSTR *ret)
282 {
283     BSTR str;
284
285     static const WCHAR native_prefixW[] = {'\n','f','u','n','c','t','i','o','n',' '};
286     static const WCHAR native_suffixW[] =
287         {'(',')',' ','{','\n',' ',' ',' ',' ','[','n','a','t','i','v','e',' ','c','o','d','e',']','\n','}','\n'};
288
289     if(function->value_proc) {
290         DWORD name_len;
291
292         name_len = strlenW(function->name);
293         str = SysAllocStringLen(NULL, sizeof(native_prefixW) + name_len*sizeof(WCHAR) + sizeof(native_suffixW));
294         if(!str)
295             return E_OUTOFMEMORY;
296
297         memcpy(str, native_prefixW, sizeof(native_prefixW));
298         memcpy(str + sizeof(native_prefixW)/sizeof(WCHAR), function->name, name_len*sizeof(WCHAR));
299         memcpy(str + sizeof(native_prefixW)/sizeof(WCHAR) + name_len, native_suffixW, sizeof(native_suffixW));
300     }else {
301         str = SysAllocStringLen(function->src_str, function->src_len);
302         if(!str)
303             return E_OUTOFMEMORY;
304     }
305
306     *ret = str;
307     return S_OK;
308 }
309
310 static HRESULT Function_length(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
311         VARIANT *retv, jsexcept_t *ei, IServiceProvider *sp)
312 {
313     FunctionInstance *This = function_from_vdisp(jsthis);
314
315     TRACE("%p %d\n", This, This->length);
316
317     switch(flags) {
318     case DISPATCH_PROPERTYGET:
319         V_VT(retv) = VT_I4;
320         V_I4(retv) = This->length;
321         break;
322     default:
323         FIXME("unimplemented flags %x\n", flags);
324         return E_NOTIMPL;
325     }
326
327     return S_OK;
328 }
329
330 static HRESULT Function_toString(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
331         VARIANT *retv, jsexcept_t *ei, IServiceProvider *sp)
332 {
333     FunctionInstance *function;
334     BSTR str;
335     HRESULT hres;
336
337     TRACE("\n");
338
339     if(!(function = function_this(jsthis)))
340         return throw_type_error(ctx, ei, IDS_NOT_FUNC, NULL);
341
342     hres = function_to_string(function, &str);
343     if(FAILED(hres))
344         return hres;
345
346     if(retv) {
347         V_VT(retv) = VT_BSTR;
348         V_BSTR(retv) = str;
349     }else {
350         SysFreeString(str);
351     }
352     return S_OK;
353 }
354
355 static HRESULT array_to_args(script_ctx_t *ctx, DispatchEx *arg_array, jsexcept_t *ei, IServiceProvider *caller,
356         DISPPARAMS *args)
357 {
358     VARIANT var, *argv;
359     DWORD length, i;
360     HRESULT hres;
361
362     hres = jsdisp_propget_name(arg_array, lengthW, &var, ei, NULL/*FIXME*/);
363     if(FAILED(hres))
364         return hres;
365
366     hres = to_uint32(ctx, &var, ei, &length);
367     VariantClear(&var);
368     if(FAILED(hres))
369         return hres;
370
371     argv = heap_alloc(length * sizeof(VARIANT));
372     if(!argv)
373         return E_OUTOFMEMORY;
374
375     for(i=0; i<length; i++) {
376         hres = jsdisp_propget_idx(arg_array, i, argv+i, ei, caller);
377         if(FAILED(hres)) {
378             while(i--)
379                 VariantClear(argv+i);
380             heap_free(argv);
381             return hres;
382         }
383     }
384
385     args->cArgs = length;
386     args->rgvarg = argv;
387     return S_OK;
388 }
389
390 static HRESULT Function_apply(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
391         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
392 {
393     FunctionInstance *function;
394     DISPPARAMS args = {NULL,NULL,0,0};
395     DWORD argc, i;
396     IDispatch *this_obj = NULL;
397     HRESULT hres = S_OK;
398
399     TRACE("\n");
400
401     if(!(function = function_this(jsthis)))
402         return throw_type_error(ctx, ei, IDS_NOT_FUNC, NULL);
403
404     argc = arg_cnt(dp);
405     if(argc) {
406         hres = to_object(ctx, get_arg(dp,0), &this_obj);
407         if(FAILED(hres))
408             return hres;
409     }
410
411     if(argc >= 2) {
412         DispatchEx *arg_array = NULL;
413
414         if(V_VT(get_arg(dp,1)) == VT_DISPATCH) {
415             arg_array = iface_to_jsdisp((IUnknown*)V_DISPATCH(get_arg(dp,1)));
416             if(arg_array && (
417                 !is_class(arg_array, JSCLASS_ARRAY) && !is_class(arg_array, JSCLASS_ARGUMENTS) )) {
418                 jsdisp_release(arg_array);
419                 arg_array = NULL;
420             }
421         }
422
423         if(arg_array) {
424             hres = array_to_args(ctx, arg_array, ei, caller, &args);
425             jsdisp_release(arg_array);
426         }else {
427             FIXME("throw TypeError\n");
428             hres = E_FAIL;
429         }
430     }
431
432     hres = call_function(ctx, function, this_obj, &args, retv, ei, caller);
433
434     if(this_obj)
435         IDispatch_Release(this_obj);
436     for(i=0; i<args.cArgs; i++)
437         VariantClear(args.rgvarg+i);
438     heap_free(args.rgvarg);
439     return hres;
440 }
441
442 static HRESULT Function_call(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
443         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
444 {
445     FunctionInstance *function;
446     DISPPARAMS args = {NULL,NULL,0,0};
447     IDispatch *this_obj = NULL;
448     DWORD argc;
449     HRESULT hres;
450
451     TRACE("\n");
452
453     if(!(function = function_this(jsthis)))
454         return throw_type_error(ctx, ei, IDS_NOT_FUNC, NULL);
455
456     argc = arg_cnt(dp);
457     if(argc) {
458         hres = to_object(ctx, get_arg(dp,0), &this_obj);
459         if(FAILED(hres))
460             return hres;
461         args.cArgs = argc-1;
462     }
463
464     if(args.cArgs)
465         args.rgvarg = dp->rgvarg + dp->cArgs - args.cArgs-1;
466
467     hres = call_function(ctx, function, this_obj, &args, retv, ei, caller);
468
469     if(this_obj)
470         IDispatch_Release(this_obj);
471     return hres;
472 }
473
474 HRESULT Function_value(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
475         VARIANT *retv, jsexcept_t *ei, IServiceProvider *caller)
476 {
477     FunctionInstance *function;
478
479     TRACE("\n");
480
481     if(!is_vclass(jsthis, JSCLASS_FUNCTION)) {
482         ERR("dispex is not a function\n");
483         return E_FAIL;
484     }
485
486     function = (FunctionInstance*)jsthis->u.jsdisp;
487
488     switch(flags) {
489     case DISPATCH_METHOD:
490         if(function->value_proc)
491             return invoke_value_proc(ctx, function, get_this(dp), flags, dp, retv, ei, caller);
492
493         return invoke_source(ctx, function, get_this(dp), dp, retv, ei, caller);
494
495     case DISPATCH_PROPERTYGET: {
496         HRESULT hres;
497         BSTR str;
498
499         hres = function_to_string(function, &str);
500         if(FAILED(hres))
501             return hres;
502
503         V_VT(retv) = VT_BSTR;
504         V_BSTR(retv) = str;
505         break;
506     }
507
508     case DISPATCH_CONSTRUCT:
509         if(function->value_proc)
510             return invoke_value_proc(ctx, function, get_this(dp), flags, dp, retv, ei, caller);
511
512         return invoke_constructor(ctx, function, dp, retv, ei, caller);
513
514     default:
515         FIXME("not implemented flags %x\n", flags);
516         return E_NOTIMPL;
517     }
518
519     return S_OK;
520 }
521
522 static void Function_destructor(DispatchEx *dispex)
523 {
524     FunctionInstance *This = (FunctionInstance*)dispex;
525
526     if(This->parser)
527         parser_release(This->parser);
528     if(This->scope_chain)
529         scope_release(This->scope_chain);
530     heap_free(This);
531 }
532
533 static const builtin_prop_t Function_props[] = {
534     {applyW,                 Function_apply,                 PROPF_METHOD|2},
535     {callW,                  Function_call,                  PROPF_METHOD|1},
536     {lengthW,                Function_length,                0},
537     {toStringW,              Function_toString,              PROPF_METHOD}
538 };
539
540 static const builtin_info_t Function_info = {
541     JSCLASS_FUNCTION,
542     {NULL, Function_value, 0},
543     sizeof(Function_props)/sizeof(*Function_props),
544     Function_props,
545     Function_destructor,
546     NULL
547 };
548
549 static HRESULT FunctionConstr_value(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
550         VARIANT *retv, jsexcept_t *ei, IServiceProvider *sp)
551 {
552     FIXME("\n");
553     return E_NOTIMPL;
554 }
555
556 static HRESULT FunctionProt_value(script_ctx_t *ctx, vdisp_t *jsthis, WORD flags, DISPPARAMS *dp,
557         VARIANT *retv, jsexcept_t *ei, IServiceProvider *sp)
558 {
559     FIXME("\n");
560     return E_NOTIMPL;
561 }
562
563 static HRESULT create_function(script_ctx_t *ctx, const builtin_info_t *builtin_info, DWORD flags,
564         BOOL funcprot, DispatchEx *prototype, FunctionInstance **ret)
565 {
566     FunctionInstance *function;
567     HRESULT hres;
568
569     function = heap_alloc_zero(sizeof(FunctionInstance));
570     if(!function)
571         return E_OUTOFMEMORY;
572
573     if(funcprot)
574         hres = init_dispex(&function->dispex, ctx, &Function_info, prototype);
575     else if(builtin_info)
576         hres = init_dispex_from_constr(&function->dispex, ctx, builtin_info, ctx->function_constr);
577     else
578         hres = init_dispex_from_constr(&function->dispex, ctx, &Function_info, ctx->function_constr);
579     if(FAILED(hres))
580         return hres;
581
582     function->flags = flags;
583     function->length = flags & PROPF_ARGMASK;
584
585     *ret = function;
586     return S_OK;
587 }
588
589 static HRESULT set_prototype(script_ctx_t *ctx, DispatchEx *dispex, DispatchEx *prototype)
590 {
591     jsexcept_t jsexcept;
592     VARIANT var;
593
594     V_VT(&var) = VT_DISPATCH;
595     V_DISPATCH(&var) = (IDispatch*)_IDispatchEx_(prototype);
596     memset(&jsexcept, 0, sizeof(jsexcept));
597
598     return jsdisp_propput_name(dispex, prototypeW, &var, &jsexcept, NULL/*FIXME*/);
599 }
600
601 HRESULT create_builtin_function(script_ctx_t *ctx, builtin_invoke_t value_proc, const WCHAR *name,
602         const builtin_info_t *builtin_info, DWORD flags, DispatchEx *prototype, DispatchEx **ret)
603 {
604     FunctionInstance *function;
605     HRESULT hres;
606
607     hres = create_function(ctx, builtin_info, flags, FALSE, NULL, &function);
608     if(FAILED(hres))
609         return hres;
610
611     hres = set_prototype(ctx, &function->dispex, prototype);
612     if(FAILED(hres)) {
613         jsdisp_release(&function->dispex);
614         return hres;
615     }
616
617     function->value_proc = value_proc;
618     function->name = name;
619
620     *ret = &function->dispex;
621     return S_OK;
622 }
623
624 HRESULT create_source_function(parser_ctx_t *ctx, parameter_t *parameters, source_elements_t *source,
625         scope_chain_t *scope_chain, const WCHAR *src_str, DWORD src_len, DispatchEx **ret)
626 {
627     FunctionInstance *function;
628     DispatchEx *prototype;
629     parameter_t *iter;
630     DWORD length = 0;
631     HRESULT hres;
632
633     hres = create_object(ctx->script, NULL, &prototype);
634     if(FAILED(hres))
635         return hres;
636
637     hres = create_function(ctx->script, NULL, PROPF_CONSTR, FALSE, NULL, &function);
638     if(SUCCEEDED(hres)) {
639         hres = set_prototype(ctx->script, &function->dispex, prototype);
640         if(FAILED(hres))
641             jsdisp_release(&function->dispex);
642     }
643     jsdisp_release(prototype);
644     if(FAILED(hres))
645         return hres;
646
647     function->source = source;
648     function->parameters = parameters;
649
650     if(scope_chain) {
651         scope_addref(scope_chain);
652         function->scope_chain = scope_chain;
653     }
654
655     parser_addref(ctx);
656     function->parser = ctx;
657
658     for(iter = parameters; iter; iter = iter->next)
659         length++;
660     function->length = length;
661
662     function->src_str = src_str;
663     function->src_len = src_len;
664
665     *ret = &function->dispex;
666     return S_OK;
667 }
668
669 HRESULT init_function_constr(script_ctx_t *ctx, DispatchEx *object_prototype)
670 {
671     FunctionInstance *prot, *constr;
672     HRESULT hres;
673
674     static const WCHAR FunctionW[] = {'F','u','n','c','t','i','o','n',0};
675
676     hres = create_function(ctx, NULL, PROPF_CONSTR, TRUE, object_prototype, &prot);
677     if(FAILED(hres))
678         return hres;
679
680     prot->value_proc = FunctionProt_value;
681     prot->name = prototypeW;
682
683     hres = create_function(ctx, NULL, PROPF_CONSTR|1, TRUE, &prot->dispex, &constr);
684     if(SUCCEEDED(hres)) {
685         constr->value_proc = FunctionConstr_value;
686         constr->name = FunctionW;
687         hres = set_prototype(ctx, &constr->dispex, &prot->dispex);
688         if(FAILED(hres))
689             jsdisp_release(&constr->dispex);
690     }
691     jsdisp_release(&prot->dispex);
692     if(FAILED(hres))
693         return hres;
694
695     ctx->function_constr = &constr->dispex;
696     return S_OK;
697 }