The DdeCreateStringHandle function creates a handle that identifies the string pointed to by the psz parameter. A dynamic data exchange (DDE) client or server application can pass the string handle as a parameter to other Dynamic Data Exchange Management Library (DDEML) functions.
HSZ DdeCreateStringHandle(
DWORD idInst, |
// instance identifier |
LPTSTR psz, |
// pointer to null-terminated string |
int iCodePage |
// code page identifier |
); |
If the function succeeds, the return value is a string handle.
If the function fails, the return value is 0L.
The DdeGetLastError function can be used to get the error code, which may be one of the following values:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
DMLERR_SYS_ERROR
The value of a string handle is not related to the case of the string it identifies.
When an application either creates a string handle or receives one in the callback function and then uses the DdeKeepStringHandle function to keep it, the application must free that string handle when it is no longer needed.
An instance-specific string handle cannot be mapped from string handle to string and back to string handle. This is shown in the following example, in which the DdeQueryString function creates a string from a string handle and DdeCreateStringHandle creates a string handle from that string, but the two handles are not the same:
DWORD idInst; DWORD cb; HSZ hszInst, hszNew; PSZ pszInst; DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI); hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI); // hszNew != hszInst !
DdeAccessData, DdeCmpStringHandles, DdeFreeStringHandle, DdeInitialize, DdeKeepStringHandle, DdeQueryString
file: /Techref/os/win/api/win32/func/src/f13_10.htm, 4KB, , updated: 2000/4/7 12:19, local time: 2024/8/23 15:58,
3.144.243.82:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://massmind.org/Techref/os/win/api/win32/func/src/f13_10.htm"> DdeCreateStringHandle</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Ashley Roll has put together a really nice little unit here. Leave off the MAX232 and keep these handy for the few times you need true RS232! |
.