2 * Server-side window stations and desktops handling
4 * Copyright (C) 2002, 2005 Alexandre Julliard
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.
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.
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
22 #include "wine/port.h"
28 #define WIN32_NO_STATUS
41 #include "wine/unicode.h"
44 static struct list winstation_list
= LIST_INIT(winstation_list
);
45 static struct namespace *winstation_namespace
;
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
);
58 static const struct object_ops winstation_ops
=
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 */
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 */
79 static const struct object_ops desktop_ops
=
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 */
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 */
99 #define DESKTOP_ALL_ACCESS 0x01ff
101 /* create a winstation object */
102 static struct winstation
*create_winstation( const struct unicode_str
*name
, unsigned int attr
,
105 struct winstation
*winstation
;
107 if (!winstation_namespace
&& !(winstation_namespace
= create_namespace( 7 )))
110 if (memchrW( name
->str
, '\\', name
->len
/ sizeof(WCHAR
) )) /* no backslash allowed in name */
112 set_error( STATUS_INVALID_PARAMETER
);
116 if ((winstation
= create_named_object( winstation_namespace
, &winstation_ops
, name
, attr
)))
118 if (get_error() != STATUS_OBJECT_NAME_EXISTS
)
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
);
131 static void winstation_dump( struct object
*obj
, int verbose
)
133 struct winstation
*winstation
= (struct winstation
*)obj
;
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
);
141 static struct object_type
*winstation_get_type( struct object
*obj
)
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
);
148 static int winstation_close_handle( struct object
*obj
, struct process
*process
, obj_handle_t handle
)
150 return (process
->winstation
!= handle
);
153 static void winstation_destroy( struct object
*obj
)
155 struct winstation
*winstation
= (struct winstation
*)obj
;
157 list_remove( &winstation
->entry
);
158 if (winstation
->clipboard
) release_object( winstation
->clipboard
);
159 if (winstation
->atom_table
) release_object( winstation
->atom_table
);
162 static unsigned int winstation_map_access( struct object
*obj
, unsigned int access
)
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
);
173 /* retrieve the process window station, checking the handle access rights */
174 struct winstation
*get_process_winstation( struct process
*process
, unsigned int access
)
176 return (struct winstation
*)get_handle_obj( process
, process
->winstation
,
177 access
, &winstation_ops
);
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
)
184 const WCHAR
*winstation_name
;
186 data_size_t winstation_len
;
188 if (memchrW( name
->str
, '\\', name
->len
/ sizeof(WCHAR
) ))
190 set_error( STATUS_INVALID_PARAMETER
);
194 if (!(winstation_name
= get_object_name( &winstation
->obj
, &winstation_len
)))
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
;
206 /* retrieve a pointer to a desktop object */
207 struct desktop
*get_desktop_obj( struct process
*process
, obj_handle_t handle
, unsigned int access
)
209 return (struct desktop
*)get_handle_obj( process
, handle
, access
, &desktop_ops
);
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
)
216 struct desktop
*desktop
;
217 struct unicode_str full_str
;
220 if (!(full_name
= build_desktop_name( name
, winstation
, &full_str
))) return NULL
;
222 if ((desktop
= create_named_object( winstation_namespace
, &desktop_ops
, &full_str
, attr
)))
224 if (get_error() != STATUS_OBJECT_NAME_EXISTS
)
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
->msg_window
= NULL
;
231 desktop
->global_hooks
= NULL
;
232 desktop
->close_timeout
= NULL
;
233 desktop
->foreground_input
= NULL
;
235 memset( &desktop
->cursor
, 0, sizeof(desktop
->cursor
) );
236 memset( desktop
->keystate
, 0, sizeof(desktop
->keystate
) );
237 list_add_tail( &winstation
->desktops
, &desktop
->entry
);
238 list_init( &desktop
->hotkeys
);
245 static void desktop_dump( struct object
*obj
, int verbose
)
247 struct desktop
*desktop
= (struct desktop
*)obj
;
249 fprintf( stderr
, "Desktop flags=%x winstation=%p top_win=%p hooks=%p ",
250 desktop
->flags
, desktop
->winstation
, desktop
->top_window
, desktop
->global_hooks
);
251 dump_object_name( &desktop
->obj
);
252 fputc( '\n', stderr
);
255 static struct object_type
*desktop_get_type( struct object
*obj
)
257 static const WCHAR name
[] = {'D','e','s','k','t','o','p'};
258 static const struct unicode_str str
= { name
, sizeof(name
) };
259 return get_object_type( &str
);
262 static int desktop_close_handle( struct object
*obj
, struct process
*process
, obj_handle_t handle
)
264 struct thread
*thread
;
266 /* check if the handle is currently used by the process or one of its threads */
267 if (process
->desktop
== handle
) return 0;
268 LIST_FOR_EACH_ENTRY( thread
, &process
->thread_list
, struct thread
, proc_entry
)
269 if (thread
->desktop
== handle
) return 0;
273 static void desktop_destroy( struct object
*obj
)
275 struct desktop
*desktop
= (struct desktop
*)obj
;
277 free_hotkeys( desktop
, 0 );
278 if (desktop
->top_window
) destroy_window( desktop
->top_window
);
279 if (desktop
->msg_window
) destroy_window( desktop
->msg_window
);
280 if (desktop
->global_hooks
) release_object( desktop
->global_hooks
);
281 if (desktop
->close_timeout
) remove_timeout_user( desktop
->close_timeout
);
282 list_remove( &desktop
->entry
);
283 release_object( desktop
->winstation
);
286 static unsigned int desktop_map_access( struct object
*obj
, unsigned int access
)
288 if (access
& GENERIC_READ
) access
|= STANDARD_RIGHTS_READ
| DESKTOP_READOBJECTS
| DESKTOP_ENUMERATE
;
289 if (access
& GENERIC_WRITE
) access
|= STANDARD_RIGHTS_WRITE
| DESKTOP_CREATEMENU
| DESKTOP_CREATEWINDOW
|
290 DESKTOP_HOOKCONTROL
| DESKTOP_JOURNALRECORD
| DESKTOP_JOURNALPLAYBACK
|
291 DESKTOP_WRITEOBJECTS
;
292 if (access
& GENERIC_EXECUTE
) access
|= STANDARD_RIGHTS_EXECUTE
| DESKTOP_SWITCHDESKTOP
;
293 if (access
& GENERIC_ALL
) access
|= STANDARD_RIGHTS_REQUIRED
| DESKTOP_ALL_ACCESS
;
294 return access
& ~(GENERIC_READ
| GENERIC_WRITE
| GENERIC_EXECUTE
| GENERIC_ALL
);
297 /* retrieve the thread desktop, checking the handle access rights */
298 struct desktop
*get_thread_desktop( struct thread
*thread
, unsigned int access
)
300 return get_desktop_obj( thread
->process
, thread
->desktop
, access
);
303 static void close_desktop_timeout( void *private )
305 struct desktop
*desktop
= private;
307 desktop
->close_timeout
= NULL
;
308 unlink_named_object( &desktop
->obj
); /* make sure no other process can open it */
309 post_desktop_message( desktop
, WM_CLOSE
, 0, 0 ); /* and signal the owner to quit */
312 /* add a user of the desktop and cancel the close timeout */
313 static void add_desktop_user( struct desktop
*desktop
)
316 if (desktop
->close_timeout
)
318 remove_timeout_user( desktop
->close_timeout
);
319 desktop
->close_timeout
= NULL
;
323 /* remove a user of the desktop and start the close timeout if necessary */
324 static void remove_desktop_user( struct desktop
*desktop
)
326 assert( desktop
->users
> 0 );
329 /* if we have one remaining user, it has to be the manager of the desktop window */
330 if (desktop
->users
== 1 && get_top_window_owner( desktop
))
332 assert( !desktop
->close_timeout
);
333 desktop
->close_timeout
= add_timeout_user( -TICKS_PER_SEC
, close_desktop_timeout
, desktop
);
337 /* set the process default desktop handle */
338 void set_process_default_desktop( struct process
*process
, struct desktop
*desktop
,
339 obj_handle_t handle
)
341 struct thread
*thread
;
342 struct desktop
*old_desktop
;
344 if (process
->desktop
== handle
) return; /* nothing to do */
346 if (!(old_desktop
= get_desktop_obj( process
, process
->desktop
, 0 ))) clear_error();
347 process
->desktop
= handle
;
349 /* set desktop for threads that don't have one yet */
350 LIST_FOR_EACH_ENTRY( thread
, &process
->thread_list
, struct thread
, proc_entry
)
351 if (!thread
->desktop
) thread
->desktop
= handle
;
353 if (!process
->is_system
&& desktop
!= old_desktop
)
355 add_desktop_user( desktop
);
356 if (old_desktop
) remove_desktop_user( old_desktop
);
359 if (old_desktop
) release_object( old_desktop
);
362 /* connect a process to its window station */
363 void connect_process_winstation( struct process
*process
, struct thread
*parent
)
365 struct winstation
*winstation
= NULL
;
366 struct desktop
*desktop
= NULL
;
369 /* check for an inherited winstation handle (don't ask...) */
370 if ((handle
= find_inherited_handle( process
, &winstation_ops
)))
372 winstation
= (struct winstation
*)get_handle_obj( process
, handle
, 0, &winstation_ops
);
374 else if (parent
&& parent
->process
->winstation
)
376 handle
= duplicate_handle( parent
->process
, parent
->process
->winstation
,
377 process
, 0, 0, DUP_HANDLE_SAME_ACCESS
);
378 winstation
= (struct winstation
*)get_handle_obj( process
, handle
, 0, &winstation_ops
);
380 if (!winstation
) goto done
;
381 process
->winstation
= handle
;
383 if ((handle
= find_inherited_handle( process
, &desktop_ops
)))
385 desktop
= get_desktop_obj( process
, handle
, 0 );
386 if (!desktop
|| desktop
->winstation
!= winstation
) goto done
;
388 else if (parent
&& parent
->desktop
)
390 desktop
= get_desktop_obj( parent
->process
, parent
->desktop
, 0 );
391 if (!desktop
|| desktop
->winstation
!= winstation
) goto done
;
392 handle
= duplicate_handle( parent
->process
, parent
->desktop
,
393 process
, 0, 0, DUP_HANDLE_SAME_ACCESS
);
396 if (handle
) set_process_default_desktop( process
, desktop
, handle
);
399 if (desktop
) release_object( desktop
);
400 if (winstation
) release_object( winstation
);
404 /* close the desktop of a given process */
405 void close_process_desktop( struct process
*process
)
407 struct desktop
*desktop
;
409 if (process
->desktop
&& (desktop
= get_desktop_obj( process
, process
->desktop
, 0 )))
411 remove_desktop_user( desktop
);
412 release_object( desktop
);
414 clear_error(); /* ignore errors */
417 /* close the desktop of a given thread */
418 void close_thread_desktop( struct thread
*thread
)
420 obj_handle_t handle
= thread
->desktop
;
423 if (handle
) close_handle( thread
->process
, handle
);
426 /* set the reply data from the object name */
427 static void set_reply_data_obj_name( struct object
*obj
)
430 const WCHAR
*ptr
, *name
= get_object_name( obj
, &len
);
432 /* if there is a backslash return the part of the name after it */
433 if (name
&& (ptr
= memchrW( name
, '\\', len
/sizeof(WCHAR
) )))
435 len
-= (ptr
+ 1 - name
) * sizeof(WCHAR
);
438 if (name
) set_reply_data( name
, min( len
, get_reply_max_size() ));
441 /* create a window station */
442 DECL_HANDLER(create_winstation
)
444 struct winstation
*winstation
;
445 struct unicode_str name
;
448 get_req_unicode_str( &name
);
449 if ((winstation
= create_winstation( &name
, req
->attributes
, req
->flags
)))
451 reply
->handle
= alloc_handle( current
->process
, winstation
, req
->access
, req
->attributes
);
452 release_object( winstation
);
456 /* open a handle to a window station */
457 DECL_HANDLER(open_winstation
)
459 struct unicode_str name
;
461 get_req_unicode_str( &name
);
462 if (winstation_namespace
)
463 reply
->handle
= open_object( winstation_namespace
, &name
, &winstation_ops
, req
->access
,
466 set_error( STATUS_OBJECT_NAME_NOT_FOUND
);
470 /* close a window station */
471 DECL_HANDLER(close_winstation
)
473 struct winstation
*winstation
;
475 if ((winstation
= (struct winstation
*)get_handle_obj( current
->process
, req
->handle
,
476 0, &winstation_ops
)))
478 if (close_handle( current
->process
, req
->handle
)) set_error( STATUS_ACCESS_DENIED
);
479 release_object( winstation
);
484 /* get the process current window station */
485 DECL_HANDLER(get_process_winstation
)
487 reply
->handle
= current
->process
->winstation
;
491 /* set the process current window station */
492 DECL_HANDLER(set_process_winstation
)
494 struct winstation
*winstation
;
496 if ((winstation
= (struct winstation
*)get_handle_obj( current
->process
, req
->handle
,
497 0, &winstation_ops
)))
499 /* FIXME: should we close the old one? */
500 current
->process
->winstation
= req
->handle
;
501 release_object( winstation
);
505 /* create a desktop */
506 DECL_HANDLER(create_desktop
)
508 struct desktop
*desktop
;
509 struct winstation
*winstation
;
510 struct unicode_str name
;
513 get_req_unicode_str( &name
);
514 if ((winstation
= get_process_winstation( current
->process
, WINSTA_CREATEDESKTOP
)))
516 if ((desktop
= create_desktop( &name
, req
->attributes
, req
->flags
, winstation
)))
518 reply
->handle
= alloc_handle( current
->process
, desktop
, req
->access
, req
->attributes
);
519 release_object( desktop
);
521 release_object( winstation
);
525 /* open a handle to a desktop */
526 DECL_HANDLER(open_desktop
)
528 struct winstation
*winstation
;
529 struct unicode_str name
;
531 get_req_unicode_str( &name
);
533 /* FIXME: check access rights */
535 winstation
= get_process_winstation( current
->process
, 0 );
537 winstation
= (struct winstation
*)get_handle_obj( current
->process
, req
->winsta
, 0, &winstation_ops
);
541 struct unicode_str full_str
;
544 if ((full_name
= build_desktop_name( &name
, winstation
, &full_str
)))
546 reply
->handle
= open_object( winstation_namespace
, &full_str
, &desktop_ops
, req
->access
,
550 release_object( winstation
);
554 /* open a handle to current input desktop */
555 DECL_HANDLER(open_input_desktop
)
557 /* FIXME: check access rights */
558 struct winstation
*winstation
= get_process_winstation( current
->process
, 0 );
559 struct desktop
*desktop
;
561 if (!winstation
) return;
563 if (!(winstation
->flags
& WSF_VISIBLE
))
565 set_error( STATUS_ILLEGAL_FUNCTION
);
566 release_object( winstation
);
570 if ((desktop
= get_desktop_obj( current
->process
, current
->process
->desktop
, 0 )))
572 reply
->handle
= alloc_handle( current
->process
, desktop
, req
->access
, req
->attributes
);
573 release_object( desktop
);
575 release_object( winstation
);
578 /* close a desktop */
579 DECL_HANDLER(close_desktop
)
581 struct desktop
*desktop
;
583 /* make sure it is a desktop handle */
584 if ((desktop
= (struct desktop
*)get_handle_obj( current
->process
, req
->handle
,
587 if (close_handle( current
->process
, req
->handle
)) set_error( STATUS_DEVICE_BUSY
);
588 release_object( desktop
);
593 /* get the thread current desktop */
594 DECL_HANDLER(get_thread_desktop
)
596 struct thread
*thread
;
598 if (!(thread
= get_thread_from_id( req
->tid
))) return;
599 reply
->handle
= thread
->desktop
;
600 release_object( thread
);
604 /* set the thread current desktop */
605 DECL_HANDLER(set_thread_desktop
)
607 struct desktop
*old_desktop
, *new_desktop
;
608 struct winstation
*winstation
;
610 if (!(winstation
= get_process_winstation( current
->process
, 0 /* FIXME: access rights? */ )))
613 if (!(new_desktop
= get_desktop_obj( current
->process
, req
->handle
, 0 )))
615 release_object( winstation
);
618 if (new_desktop
->winstation
!= winstation
)
620 set_error( STATUS_ACCESS_DENIED
);
621 release_object( new_desktop
);
622 release_object( winstation
);
626 /* check if we are changing to a new desktop */
628 if (!(old_desktop
= get_desktop_obj( current
->process
, current
->desktop
, 0)))
629 clear_error(); /* ignore error */
631 /* when changing desktop, we can't have any users on the current one */
632 if (old_desktop
!= new_desktop
&& current
->desktop_users
> 0)
633 set_error( STATUS_DEVICE_BUSY
);
635 current
->desktop
= req
->handle
; /* FIXME: should we close the old one? */
637 if (!current
->process
->desktop
)
638 set_process_default_desktop( current
->process
, new_desktop
, req
->handle
);
640 if (old_desktop
!= new_desktop
&& current
->queue
) detach_thread_input( current
);
642 if (old_desktop
) release_object( old_desktop
);
643 release_object( new_desktop
);
644 release_object( winstation
);
648 /* get/set information about a user object (window station or desktop) */
649 DECL_HANDLER(set_user_object_info
)
653 if (!(obj
= get_handle_obj( current
->process
, req
->handle
, 0, NULL
))) return;
655 if (obj
->ops
== &desktop_ops
)
657 struct desktop
*desktop
= (struct desktop
*)obj
;
658 reply
->is_desktop
= 1;
659 reply
->old_obj_flags
= desktop
->flags
;
660 if (req
->flags
& SET_USER_OBJECT_FLAGS
) desktop
->flags
= req
->obj_flags
;
662 else if (obj
->ops
== &winstation_ops
)
664 struct winstation
*winstation
= (struct winstation
*)obj
;
665 reply
->is_desktop
= 0;
666 reply
->old_obj_flags
= winstation
->flags
;
667 if (req
->flags
& SET_USER_OBJECT_FLAGS
) winstation
->flags
= req
->obj_flags
;
671 set_error( STATUS_OBJECT_TYPE_MISMATCH
);
672 release_object( obj
);
675 if (get_reply_max_size()) set_reply_data_obj_name( obj
);
676 release_object( obj
);
680 /* enumerate window stations */
681 DECL_HANDLER(enum_winstation
)
683 unsigned int index
= 0;
684 struct winstation
*winsta
;
686 LIST_FOR_EACH_ENTRY( winsta
, &winstation_list
, struct winstation
, entry
)
688 unsigned int access
= WINSTA_ENUMERATE
;
689 if (req
->index
> index
++) continue;
690 if (!check_object_access( &winsta
->obj
, &access
)) continue;
691 set_reply_data_obj_name( &winsta
->obj
);
696 set_error( STATUS_NO_MORE_ENTRIES
);
700 /* enumerate desktops */
701 DECL_HANDLER(enum_desktop
)
703 struct winstation
*winstation
;
704 struct desktop
*desktop
;
705 unsigned int index
= 0;
707 if (!(winstation
= (struct winstation
*)get_handle_obj( current
->process
, req
->winstation
,
708 WINSTA_ENUMDESKTOPS
, &winstation_ops
)))
711 LIST_FOR_EACH_ENTRY( desktop
, &winstation
->desktops
, struct desktop
, entry
)
713 unsigned int access
= DESKTOP_ENUMERATE
;
714 if (req
->index
> index
++) continue;
715 if (!desktop
->obj
.name
) continue;
716 if (!check_object_access( &desktop
->obj
, &access
)) continue;
717 set_reply_data_obj_name( &desktop
->obj
);
718 release_object( winstation
);
724 release_object( winstation
);
725 set_error( STATUS_NO_MORE_ENTRIES
);