osOpenByHandle Function
Declaration:
BOOL osOpenByHandle( HANDLE Handle );
Parameters:
Handle
The handle of the object to be opened.
Return value:
TRUE on success or FALSE on failure. Call the osGetLastError function to obtain extended error information.
Description:
This function opens an object using its handle rather than its name (unlike other osOpen* functions). It is typically used when the object's handle is already known and the calling task needs to increment the object's reference count to protect it from being deleted by other tasks.
This function is available only when the OS_OPEN_BY_HANDLE_FUNC constant is set to 1.
| Version: | 1.0 |
|---|---|
| Header file: | OS_API.h |
| See also: | BOOL, FALSE, HANDLE, OS_OPEN_BY_HANDLE_FUNC, osGetLastError, system objects management, TRUE |
SpaceShadow documentation
- About SpaceShadow products
- Architecture dependencies
- Standard Library
- Operating System Kernel
- Real-time performance
- Scheduling
- Synchronization
- Interprocess communication
- Interrupts
- System objects management
- System objects
- Using the operating system
- Examples
- Constants
- Configuration
- OS_ALLOW_OBJECT_DELETION
- OS_FIX_POOL0_ITEM_SIZE
- OS_FIX_POOL0_SIZE
- OS_FIX_POOL1_ITEM_SIZE
- OS_FIX_POOL1_SIZE
- OS_FIX_POOL2_ITEM_SIZE
- OS_FIX_POOL2_SIZE
- OS_FIX_POOL3_ITEM_SIZE
- OS_FIX_POOL3_SIZE
- OS_DEINIT_FUNC
- OS_GET_SYSTEM_STAT_FUNC
- OS_IDLE_STACK_SIZE
- OS_INTERNAL_MEMORY_SIZE
- OS_LOWEST_USED_PRIORITY
- OS_MAX_WAIT_FOR_OBJECTS
- OS_OPEN_BY_HANDLE_FUNC
- OS_READ_WRITE_FUNC
- OS_RESUME_IMMEDIATELY
- OS_STACK_SIZE
- OS_STAT_SAMPLE_RATE
- OS_STOP_FUNC
- OS_SYS_OBJECT_MAX_NAME_LEN
- OS_USE_FIXMEM_POOLS
- OS_USE_WAITING_WITH_TIME_OUT
- OS_USED
- Functions
- Types