DdeQueryString函数将与字符串句柄关联的文本复制到缓冲区中。
DWORD DdeQueryString(
DWORD 【idInst】, | //实例标识符en |
HSZ 【帖子】, | //处理字符串 |
LPTSTR 【PES】, | //指向目标缓冲区的指针 |
DWORD 【cchMax】, | //缓冲区的长度 |
INT 【iCodePage】 | //代码页标识符 |
); |
参数
【idInst】
指定通过先前调用DdeInitialize函数获得的应用程序实例标识符。
【帖子】
标识要复制的字符串。此句柄必须由先前调用DdeCreateStringHandle函数创建。
【PES】
指向接收字符串的缓冲区。要获取字符串的长度,此参数应设置为NULL。
【cchMax】
指定【PES】参数指向的缓冲区的长度(以字符为单位)。如果字符串长于(【cchMax】 - 1),它将被截断。如果【PES】参数设置为NULL,则忽略此参数。
【iCodePage】
指定用于呈现字符串的代码页。该值应为CP_WINANSI或CP_WINUNICODE。
返回值
如果【PES】参数指定了有效的指针,则返回值是返回文本的长度(以字符为单位)(不包括终止空字符)。如果【PES】参数指定了NULL指针,则返回值是与【帖子】参数关联的文本的长度(不包括终止空字符)。如果发生错误,返回值为0L。
备注
缓冲区中返回的字符串始终为空终止。如果字符串长于(【cchMax】 - 1),则只会复制字符串的第一个(【cchMax】 - 1)个字符。
如果【PES】参数为NULL,则DdeQueryString函数获取与字符串句柄相关联的字符串的长度(以字节为单位)。长度不包括终止空字符。
也可以看看
DdeCmpStringHandles, DdeCreateStringHandle, DdeFreeStringHandle, DdeInitialize