A | B | C |  D | E | F |  G | H | I |  J | K | L |  M | N | O |  P | Q | R |  S | T | U |  V | W | X |  Y | Z



DdeQueryString

The DdeQueryString function copies text associated with a string handle into a buffer.

VB4-32,5,6
Declare Function DdeQueryString Lib "user32" Alias "DdeQueryStringA" (ByVal idInst As Long, ByVal hsz As Long, ByVal psz As String, ByVal cchMax As Long, ByVal iCodePage As Long) As Long

Operating Systems Supported
Requires Windows NT 3.1 or later; Requires Windows 95 or later

Library
User32

Parameter Information
- idInst
Specifies the application instance identifier obtained by a previous call to the DdeInitialize function.

- hsz
Identifies the string to copy. This handle must have been created by a previous call to the DdeCreateStringHandle function.

- psz
Points to a buffer that receives the string. To obtain the length of the string, this parameter should be set to NULL.

- cchMax
Specifies the length, in characters, of the buffer pointed to by the psz parameter. If the string is longer than (cchMax - 1), it will be truncated. If the psz parameter is set to NULL, this parameter is ignored.

- iCodePage
Specifies the code page used to render the string. This value should be either CP_WINANSI or CP_WINUNICODE.

Return Values
If the psz parameter specified a valid pointer, the return value is the length, in characters, of the returned text (not including the terminating null character). If the psz parameter specified a NULL pointer, the return value is the length of the text associated with the hsz parameter (not including the terminating null character). If an error occurs, the return value is 0L.

Last update: 07 April 2006