DdeQueryString

【勇芳软件工作室】汉化HomePreviousNext

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