(Page 20 of 36 in this chapter) Version
dispSetHandleValue
Description
- Associates a value with a dispatcher created handle.
Prototype
- DWORD dispSetHandleValue ( unsigned hd,
unsigned value)
- hd Handle returned by dispCreateHandle.
- value The value to associate with a given handle.
Return Values
Events
Details
- This function associates the specified value with the dispatcher created handle. The value can be any value that fits into an unsigned integer (pointer or index). It is typically used for managing the mapping of API (client) side user handles to context handles and service (server) side handles. This is useful for services, such as the Voice Message service, that create another set of objects that are also associated with the context.
- The value can be retrieved by using dispGetHandleValue and can also be set directly in the call to dispCreateHandle.
See Also
- dispCreateHandle
, dispDestroyHandle, dispGetHandleValue
(Page 20 of 36 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, Natural MicroSystems, Inc. All rights
reserved.