rpcrt4: Zero the memory of the s1 structure in test_simple_struct to avoid a Valgrind...
[wine] / server / winstation.c
1 /*
2  * Server-side window stations and desktops handling
3  *
4  * Copyright (C) 2002, 2005 Alexandre Julliard
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 #include "config.h"
22 #include "wine/port.h"
23
24 #include <stdio.h>
25 #include <stdarg.h>
26
27 #include "ntstatus.h"
28 #define WIN32_NO_STATUS
29 #include "windef.h"
30 #include "winbase.h"
31 #include "winuser.h"
32 #include "winternl.h"
33
34 #include "object.h"
35 #include "handle.h"
36 #include "request.h"
37 #include "process.h"
38 #include "user.h"
39 #include "file.h"
40 #include "security.h"
41 #include "wine/unicode.h"
42
43
44 static struct list winstation_list = LIST_INIT(winstation_list);
45 static struct namespace *winstation_namespace;
46
47 static void winstation_dump( struct object *obj, int verbose );
48 static struct object_type *winstation_get_type( struct object *obj );
49 static int winstation_close_handle( struct object *obj, struct process *process, obj_handle_t handle );
50 static void winstation_destroy( struct object *obj );
51 static unsigned int winstation_map_access( struct object *obj, unsigned int access );
52 static void desktop_dump( struct object *obj, int verbose );
53 static struct object_type *desktop_get_type( struct object *obj );
54 static int desktop_close_handle( struct object *obj, struct process *process, obj_handle_t handle );
55 static void desktop_destroy( struct object *obj );
56 static unsigned int desktop_map_access( struct object *obj, unsigned int access );
57
58 static const struct object_ops winstation_ops =
59 {
60     sizeof(struct winstation),    /* size */
61     winstation_dump,              /* dump */
62     winstation_get_type,          /* get_type */
63     no_add_queue,                 /* add_queue */
64     NULL,                         /* remove_queue */
65     NULL,                         /* signaled */
66     NULL,                         /* satisfied */
67     no_signal,                    /* signal */
68     no_get_fd,                    /* get_fd */
69     winstation_map_access,        /* map_access */
70     default_get_sd,               /* get_sd */
71     default_set_sd,               /* set_sd */
72     no_lookup_name,               /* lookup_name */
73     no_open_file,                 /* open_file */
74     winstation_close_handle,      /* close_handle */
75     winstation_destroy            /* destroy */
76 };
77
78
79 static const struct object_ops desktop_ops =
80 {
81     sizeof(struct desktop),       /* size */
82     desktop_dump,                 /* dump */
83     desktop_get_type,             /* get_type */
84     no_add_queue,                 /* add_queue */
85     NULL,                         /* remove_queue */
86     NULL,                         /* signaled */
87     NULL,                         /* satisfied */
88     no_signal,                    /* signal */
89     no_get_fd,                    /* get_fd */
90     desktop_map_access,           /* map_access */
91     default_get_sd,               /* get_sd */
92     default_set_sd,               /* set_sd */
93     no_lookup_name,               /* lookup_name */
94     no_open_file,                 /* open_file */
95     desktop_close_handle,         /* close_handle */
96     desktop_destroy               /* destroy */
97 };
98
99 #define DESKTOP_ALL_ACCESS 0x01ff
100
101 /* create a winstation object */
102 static struct winstation *create_winstation( const struct unicode_str *name, unsigned int attr,
103                                              unsigned int flags )
104 {
105     struct winstation *winstation;
106
107     if (!winstation_namespace && !(winstation_namespace = create_namespace( 7 )))
108         return NULL;
109
110     if (memchrW( name->str, '\\', name->len / sizeof(WCHAR) ))  /* no backslash allowed in name */
111     {
112         set_error( STATUS_INVALID_PARAMETER );
113         return NULL;
114     }
115
116     if ((winstation = create_named_object( winstation_namespace, &winstation_ops, name, attr )))
117     {
118         if (get_error() != STATUS_OBJECT_NAME_EXISTS)
119         {
120             /* initialize it if it didn't already exist */
121             winstation->flags = flags;
122             winstation->clipboard = NULL;
123             winstation->atom_table = NULL;
124             list_add_tail( &winstation_list, &winstation->entry );
125             list_init( &winstation->desktops );
126         }
127     }
128     return winstation;
129 }
130
131 static void winstation_dump( struct object *obj, int verbose )
132 {
133     struct winstation *winstation = (struct winstation *)obj;
134
135     fprintf( stderr, "Winstation flags=%x clipboard=%p atoms=%p ",
136              winstation->flags, winstation->clipboard, winstation->atom_table );
137     dump_object_name( &winstation->obj );
138     fputc( '\n', stderr );
139 }
140
141 static struct object_type *winstation_get_type( struct object *obj )
142 {
143     static const WCHAR name[] = {'W','i','n','d','o','w','S','t','a','t','i','o','n'};
144     static const struct unicode_str str = { name, sizeof(name) };
145     return get_object_type( &str );
146 }
147
148 static int winstation_close_handle( struct object *obj, struct process *process, obj_handle_t handle )
149 {
150     return (process->winstation != handle);
151 }
152
153 static void winstation_destroy( struct object *obj )
154 {
155     struct winstation *winstation = (struct winstation *)obj;
156
157     list_remove( &winstation->entry );
158     if (winstation->clipboard) release_object( winstation->clipboard );
159     if (winstation->atom_table) release_object( winstation->atom_table );
160 }
161
162 static unsigned int winstation_map_access( struct object *obj, unsigned int access )
163 {
164     if (access & GENERIC_READ)    access |= STANDARD_RIGHTS_READ | WINSTA_ENUMDESKTOPS | WINSTA_READATTRIBUTES |
165                                             WINSTA_ENUMERATE | WINSTA_READSCREEN;
166     if (access & GENERIC_WRITE)   access |= STANDARD_RIGHTS_WRITE | WINSTA_ACCESSCLIPBOARD | WINSTA_CREATEDESKTOP |
167                                             WINSTA_WRITEATTRIBUTES;
168     if (access & GENERIC_EXECUTE) access |= STANDARD_RIGHTS_EXECUTE | WINSTA_ACCESSGLOBALATOMS | WINSTA_EXITWINDOWS;
169     if (access & GENERIC_ALL)     access |= STANDARD_RIGHTS_REQUIRED | WINSTA_ALL_ACCESS;
170     return access & ~(GENERIC_READ | GENERIC_WRITE | GENERIC_EXECUTE | GENERIC_ALL);
171 }
172
173 /* retrieve the process window station, checking the handle access rights */
174 struct winstation *get_process_winstation( struct process *process, unsigned int access )
175 {
176     return (struct winstation *)get_handle_obj( process, process->winstation,
177                                                 access, &winstation_ops );
178 }
179
180 /* build the full name of a desktop object */
181 static WCHAR *build_desktop_name( const struct unicode_str *name,
182                                   struct winstation *winstation, struct unicode_str *res )
183 {
184     const WCHAR *winstation_name;
185     WCHAR *full_name;
186     data_size_t winstation_len;
187
188     if (memchrW( name->str, '\\', name->len / sizeof(WCHAR) ))
189     {
190         set_error( STATUS_INVALID_PARAMETER );
191         return NULL;
192     }
193
194     if (!(winstation_name = get_object_name( &winstation->obj, &winstation_len )))
195         winstation_len = 0;
196
197     res->len = winstation_len + name->len + sizeof(WCHAR);
198     if (!(full_name = mem_alloc( res->len ))) return NULL;
199     memcpy( full_name, winstation_name, winstation_len );
200     full_name[winstation_len / sizeof(WCHAR)] = '\\';
201     memcpy( full_name + winstation_len / sizeof(WCHAR) + 1, name->str, name->len );
202     res->str = full_name;
203     return full_name;
204 }
205
206 /* retrieve a pointer to a desktop object */
207 struct desktop *get_desktop_obj( struct process *process, obj_handle_t handle, unsigned int access )
208 {
209     return (struct desktop *)get_handle_obj( process, handle, access, &desktop_ops );
210 }
211
212 /* create a desktop object */
213 static struct desktop *create_desktop( const struct unicode_str *name, unsigned int attr,
214                                        unsigned int flags, struct winstation *winstation )
215 {
216     struct desktop *desktop;
217     struct unicode_str full_str;
218     WCHAR *full_name;
219
220     if (!(full_name = build_desktop_name( name, winstation, &full_str ))) return NULL;
221
222     if ((desktop = create_named_object( winstation_namespace, &desktop_ops, &full_str, attr )))
223     {
224         if (get_error() != STATUS_OBJECT_NAME_EXISTS)
225         {
226             /* initialize it if it didn't already exist */
227             desktop->flags = flags;
228             desktop->winstation = (struct winstation *)grab_object( winstation );
229             desktop->top_window = NULL;
230             desktop->global_hooks = NULL;
231             desktop->close_timeout = NULL;
232             desktop->users = 0;
233             list_add_tail( &winstation->desktops, &desktop->entry );
234         }
235     }
236     free( full_name );
237     return desktop;
238 }
239
240 static void desktop_dump( struct object *obj, int verbose )
241 {
242     struct desktop *desktop = (struct desktop *)obj;
243
244     fprintf( stderr, "Desktop flags=%x winstation=%p top_win=%p hooks=%p ",
245              desktop->flags, desktop->winstation, desktop->top_window, desktop->global_hooks );
246     dump_object_name( &desktop->obj );
247     fputc( '\n', stderr );
248 }
249
250 static struct object_type *desktop_get_type( struct object *obj )
251 {
252     static const WCHAR name[] = {'D','e','s','k','t','o','p'};
253     static const struct unicode_str str = { name, sizeof(name) };
254     return get_object_type( &str );
255 }
256
257 static int desktop_close_handle( struct object *obj, struct process *process, obj_handle_t handle )
258 {
259     struct thread *thread;
260
261     /* check if the handle is currently used by the process or one of its threads */
262     if (process->desktop == handle) return 0;
263     LIST_FOR_EACH_ENTRY( thread, &process->thread_list, struct thread, proc_entry )
264         if (thread->desktop == handle) return 0;
265     return 1;
266 }
267
268 static void desktop_destroy( struct object *obj )
269 {
270     struct desktop *desktop = (struct desktop *)obj;
271
272     if (desktop->top_window) destroy_window( desktop->top_window );
273     if (desktop->global_hooks) release_object( desktop->global_hooks );
274     if (desktop->close_timeout) remove_timeout_user( desktop->close_timeout );
275     list_remove( &desktop->entry );
276     release_object( desktop->winstation );
277 }
278
279 static unsigned int desktop_map_access( struct object *obj, unsigned int access )
280 {
281     if (access & GENERIC_READ)    access |= STANDARD_RIGHTS_READ | DESKTOP_READOBJECTS | DESKTOP_ENUMERATE;
282     if (access & GENERIC_WRITE)   access |= STANDARD_RIGHTS_WRITE | DESKTOP_CREATEMENU | DESKTOP_CREATEWINDOW |
283                                             DESKTOP_HOOKCONTROL | DESKTOP_JOURNALRECORD | DESKTOP_JOURNALPLAYBACK |
284                                             DESKTOP_WRITEOBJECTS;
285     if (access & GENERIC_EXECUTE) access |= STANDARD_RIGHTS_EXECUTE | DESKTOP_SWITCHDESKTOP;
286     if (access & GENERIC_ALL)     access |= STANDARD_RIGHTS_REQUIRED | DESKTOP_ALL_ACCESS;
287     return access & ~(GENERIC_READ | GENERIC_WRITE | GENERIC_EXECUTE | GENERIC_ALL);
288 }
289
290 /* retrieve the thread desktop, checking the handle access rights */
291 struct desktop *get_thread_desktop( struct thread *thread, unsigned int access )
292 {
293     return get_desktop_obj( thread->process, thread->desktop, access );
294 }
295
296 /* set the process default desktop handle */
297 void set_process_default_desktop( struct process *process, struct desktop *desktop,
298                                   obj_handle_t handle )
299 {
300     struct thread *thread;
301     struct desktop *old_desktop;
302
303     if (process->desktop == handle) return;  /* nothing to do */
304
305     if (!(old_desktop = get_desktop_obj( process, process->desktop, 0 ))) clear_error();
306     process->desktop = handle;
307
308     /* set desktop for threads that don't have one yet */
309     LIST_FOR_EACH_ENTRY( thread, &process->thread_list, struct thread, proc_entry )
310         if (!thread->desktop) thread->desktop = handle;
311
312     if (!process->is_system)
313     {
314         desktop->users++;
315         if (desktop->close_timeout)
316         {
317             remove_timeout_user( desktop->close_timeout );
318             desktop->close_timeout = NULL;
319         }
320         if (old_desktop) old_desktop->users--;
321     }
322
323     if (old_desktop) release_object( old_desktop );
324 }
325
326 /* connect a process to its window station */
327 void connect_process_winstation( struct process *process, struct thread *parent )
328 {
329     struct winstation *winstation = NULL;
330     struct desktop *desktop = NULL;
331     obj_handle_t handle;
332
333     /* check for an inherited winstation handle (don't ask...) */
334     if ((handle = find_inherited_handle( process, &winstation_ops )))
335     {
336         winstation = (struct winstation *)get_handle_obj( process, handle, 0, &winstation_ops );
337     }
338     else if (parent && parent->process->winstation)
339     {
340         handle = duplicate_handle( parent->process, parent->process->winstation,
341                                    process, 0, 0, DUP_HANDLE_SAME_ACCESS );
342         winstation = (struct winstation *)get_handle_obj( process, handle, 0, &winstation_ops );
343     }
344     if (!winstation) goto done;
345     process->winstation = handle;
346
347     if ((handle = find_inherited_handle( process, &desktop_ops )))
348     {
349         desktop = get_desktop_obj( process, handle, 0 );
350         if (!desktop || desktop->winstation != winstation) goto done;
351     }
352     else if (parent && parent->desktop)
353     {
354         desktop = get_desktop_obj( parent->process, parent->desktop, 0 );
355         if (!desktop || desktop->winstation != winstation) goto done;
356         handle = duplicate_handle( parent->process, parent->desktop,
357                                    process, 0, 0, DUP_HANDLE_SAME_ACCESS );
358     }
359
360     if (handle) set_process_default_desktop( process, desktop, handle );
361
362 done:
363     if (desktop) release_object( desktop );
364     if (winstation) release_object( winstation );
365     clear_error();
366 }
367
368 static void close_desktop_timeout( void *private )
369 {
370     struct desktop *desktop = private;
371
372     desktop->close_timeout = NULL;
373     unlink_named_object( &desktop->obj );  /* make sure no other process can open it */
374     close_desktop_window( desktop );  /* and signal the owner to quit */
375 }
376
377 /* close the desktop of a given process */
378 void close_process_desktop( struct process *process )
379 {
380     struct desktop *desktop;
381
382     if (process->desktop && (desktop = get_desktop_obj( process, process->desktop, 0 )))
383     {
384         assert( desktop->users > 0 );
385         desktop->users--;
386         /* if we have one remaining user, it has to be the manager of the desktop window */
387         if (desktop->users == 1 && get_top_window_owner( desktop ))
388         {
389             assert( !desktop->close_timeout );
390             desktop->close_timeout = add_timeout_user( -TICKS_PER_SEC, close_desktop_timeout, desktop );
391         }
392         release_object( desktop );
393     }
394     clear_error();  /* ignore errors */
395 }
396
397 /* close the desktop of a given thread */
398 void close_thread_desktop( struct thread *thread )
399 {
400     obj_handle_t handle = thread->desktop;
401
402     thread->desktop = 0;
403     if (handle) close_handle( thread->process, handle );
404     clear_error();  /* ignore errors */
405 }
406
407 /* set the reply data from the object name */
408 static void set_reply_data_obj_name( struct object *obj )
409 {
410     data_size_t len;
411     const WCHAR *ptr, *name = get_object_name( obj, &len );
412
413     /* if there is a backslash return the part of the name after it */
414     if (name && (ptr = memchrW( name, '\\', len/sizeof(WCHAR) )))
415     {
416         len -= (ptr + 1 - name) * sizeof(WCHAR);
417         name = ptr + 1;
418     }
419     if (name) set_reply_data( name, min( len, get_reply_max_size() ));
420 }
421
422 /* create a window station */
423 DECL_HANDLER(create_winstation)
424 {
425     struct winstation *winstation;
426     struct unicode_str name;
427
428     reply->handle = 0;
429     get_req_unicode_str( &name );
430     if ((winstation = create_winstation( &name, req->attributes, req->flags )))
431     {
432         reply->handle = alloc_handle( current->process, winstation, req->access, req->attributes );
433         release_object( winstation );
434     }
435 }
436
437 /* open a handle to a window station */
438 DECL_HANDLER(open_winstation)
439 {
440     struct unicode_str name;
441
442     get_req_unicode_str( &name );
443     if (winstation_namespace)
444         reply->handle = open_object( winstation_namespace, &name, &winstation_ops, req->access,
445                                      req->attributes );
446     else
447         set_error( STATUS_OBJECT_NAME_NOT_FOUND );
448 }
449
450
451 /* close a window station */
452 DECL_HANDLER(close_winstation)
453 {
454     struct winstation *winstation;
455
456     if ((winstation = (struct winstation *)get_handle_obj( current->process, req->handle,
457                                                            0, &winstation_ops )))
458     {
459         if (!close_handle( current->process, req->handle )) set_error( STATUS_ACCESS_DENIED );
460         release_object( winstation );
461     }
462 }
463
464
465 /* get the process current window station */
466 DECL_HANDLER(get_process_winstation)
467 {
468     reply->handle = current->process->winstation;
469 }
470
471
472 /* set the process current window station */
473 DECL_HANDLER(set_process_winstation)
474 {
475     struct winstation *winstation;
476
477     if ((winstation = (struct winstation *)get_handle_obj( current->process, req->handle,
478                                                            0, &winstation_ops )))
479     {
480         /* FIXME: should we close the old one? */
481         current->process->winstation = req->handle;
482         release_object( winstation );
483     }
484 }
485
486 /* create a desktop */
487 DECL_HANDLER(create_desktop)
488 {
489     struct desktop *desktop;
490     struct winstation *winstation;
491     struct unicode_str name;
492
493     reply->handle = 0;
494     get_req_unicode_str( &name );
495     if ((winstation = get_process_winstation( current->process, WINSTA_CREATEDESKTOP )))
496     {
497         if ((desktop = create_desktop( &name, req->attributes, req->flags, winstation )))
498         {
499             reply->handle = alloc_handle( current->process, desktop, req->access, req->attributes );
500             release_object( desktop );
501         }
502         release_object( winstation );
503     }
504 }
505
506 /* open a handle to a desktop */
507 DECL_HANDLER(open_desktop)
508 {
509     struct winstation *winstation;
510     struct unicode_str name;
511
512     get_req_unicode_str( &name );
513
514     /* FIXME: check access rights */
515     if (!req->winsta)
516         winstation = get_process_winstation( current->process, 0 );
517     else
518         winstation = (struct winstation *)get_handle_obj( current->process, req->winsta, 0, &winstation_ops );
519
520     if (winstation)
521     {
522         struct unicode_str full_str;
523         WCHAR *full_name;
524
525         if ((full_name = build_desktop_name( &name, winstation, &full_str )))
526         {
527             reply->handle = open_object( winstation_namespace, &full_str, &desktop_ops, req->access,
528                                          req->attributes );
529             free( full_name );
530         }
531         release_object( winstation );
532     }
533 }
534
535
536 /* close a desktop */
537 DECL_HANDLER(close_desktop)
538 {
539     struct desktop *desktop;
540
541     /* make sure it is a desktop handle */
542     if ((desktop = (struct desktop *)get_handle_obj( current->process, req->handle,
543                                                      0, &desktop_ops )))
544     {
545         if (!close_handle( current->process, req->handle )) set_error( STATUS_DEVICE_BUSY );
546         release_object( desktop );
547     }
548 }
549
550
551 /* get the thread current desktop */
552 DECL_HANDLER(get_thread_desktop)
553 {
554     struct thread *thread;
555
556     if (!(thread = get_thread_from_id( req->tid ))) return;
557     reply->handle = thread->desktop;
558     release_object( thread );
559 }
560
561
562 /* set the thread current desktop */
563 DECL_HANDLER(set_thread_desktop)
564 {
565     struct desktop *old_desktop, *new_desktop;
566     struct winstation *winstation;
567
568     if (!(winstation = get_process_winstation( current->process, 0 /* FIXME: access rights? */ )))
569         return;
570
571     if (!(new_desktop = get_desktop_obj( current->process, req->handle, 0 )))
572     {
573         release_object( winstation );
574         return;
575     }
576     if (new_desktop->winstation != winstation)
577     {
578         set_error( STATUS_ACCESS_DENIED );
579         release_object( new_desktop );
580         release_object( winstation );
581         return;
582     }
583
584     /* check if we are changing to a new desktop */
585
586     if (!(old_desktop = get_desktop_obj( current->process, current->desktop, 0)))
587         clear_error();  /* ignore error */
588
589     /* when changing desktop, we can't have any users on the current one */
590     if (old_desktop != new_desktop && current->desktop_users > 0)
591         set_error( STATUS_DEVICE_BUSY );
592     else
593         current->desktop = req->handle;  /* FIXME: should we close the old one? */
594
595     if (!current->process->desktop)
596         set_process_default_desktop( current->process, new_desktop, req->handle );
597
598     if (old_desktop != new_desktop && current->queue) detach_thread_input( current );
599
600     if (old_desktop) release_object( old_desktop );
601     release_object( new_desktop );
602     release_object( winstation );
603 }
604
605
606 /* get/set information about a user object (window station or desktop) */
607 DECL_HANDLER(set_user_object_info)
608 {
609     struct object *obj;
610
611     if (!(obj = get_handle_obj( current->process, req->handle, 0, NULL ))) return;
612
613     if (obj->ops == &desktop_ops)
614     {
615         struct desktop *desktop = (struct desktop *)obj;
616         reply->is_desktop = 1;
617         reply->old_obj_flags = desktop->flags;
618         if (req->flags & SET_USER_OBJECT_FLAGS) desktop->flags = req->obj_flags;
619     }
620     else if (obj->ops == &winstation_ops)
621     {
622         struct winstation *winstation = (struct winstation *)obj;
623         reply->is_desktop = 0;
624         reply->old_obj_flags = winstation->flags;
625         if (req->flags & SET_USER_OBJECT_FLAGS) winstation->flags = req->obj_flags;
626     }
627     else
628     {
629         set_error( STATUS_OBJECT_TYPE_MISMATCH );
630         release_object( obj );
631         return;
632     }
633     if (get_reply_max_size()) set_reply_data_obj_name( obj );
634     release_object( obj );
635 }
636
637
638 /* enumerate window stations */
639 DECL_HANDLER(enum_winstation)
640 {
641     unsigned int index = 0;
642     struct winstation *winsta;
643
644     LIST_FOR_EACH_ENTRY( winsta, &winstation_list, struct winstation, entry )
645     {
646         unsigned int access = WINSTA_ENUMERATE;
647         if (req->index > index++) continue;
648         if (!check_object_access( &winsta->obj, &access )) continue;
649         set_reply_data_obj_name( &winsta->obj );
650         clear_error();
651         reply->next = index;
652         return;
653     }
654     set_error( STATUS_NO_MORE_ENTRIES );
655 }
656
657
658 /* enumerate desktops */
659 DECL_HANDLER(enum_desktop)
660 {
661     struct winstation *winstation;
662     struct desktop *desktop;
663     unsigned int index = 0;
664
665     if (!(winstation = (struct winstation *)get_handle_obj( current->process, req->winstation,
666                                                             WINSTA_ENUMDESKTOPS, &winstation_ops )))
667         return;
668
669     LIST_FOR_EACH_ENTRY( desktop, &winstation->desktops, struct desktop, entry )
670     {
671         unsigned int access = DESKTOP_ENUMERATE;
672         if (req->index > index++) continue;
673         if (!desktop->obj.name) continue;
674         if (!check_object_access( &desktop->obj, &access )) continue;
675         set_reply_data_obj_name( &desktop->obj );
676         release_object( winstation );
677         clear_error();
678         reply->next = index;
679         return;
680     }
681
682     release_object( winstation );
683     set_error( STATUS_NO_MORE_ENTRIES );
684 }