На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей 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.

DWORD DdeQueryString(

DWORD idInst, // instance identifier
HSZ hsz, // handle to string
LPTSTR psz, // pointer to destination buffer
DWORD cchMax, // length of buffer
int iCodePage // code page identifier
);


Parameters

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.

Remarks

The string returned in the buffer is always null-terminated. If the string is longer than (cchMax - 1), only the first (cchMax - 1) characters of the string are copied.
If the psz parameter is NULL, the DdeQueryString function obtains the length, in bytes, of the string associated with the string handle. The length does not include the terminating null character.

See Also

DdeCmpStringHandles, DdeCreateStringHandle, DdeFreeStringHandle, DdeInitialize


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DdeQueryString



Функция DdeQueryString копирует текст связывался ручкой строки в буфер.

DWORD DdeQueryString(

DWORD idInst, // ИДЕНТИФИКАТОР примера HSZ hsz, // ручка, чтобы нанизывать LPTSTR psz, // указателю в буфер расположения DWORD cchMax, // длины буферного int iCodePage // кодовый страничный идентификатор
);


Параметры

idInst

Определяет прикладной идентификатор примера полученный предшествующим вызовом в функцию DdeInitialize.

hsz

Идентифицирует строку, чтобы копироваться. Эта ручка по-видимому создана предшествующим вызовом в функцию DdeCreateStringHandle.

psz

Точки на буфер, которые получают строку. Чтобы получать длину строки, этот параметр должен быть установлен на НЕДЕЙСТВИТЕЛЬНЫЙ.

cchMax

Определяет длину, в символах, буфера указанного, чтобы psz параметром. Если строка более длинная чем (cchMax - 1), она будет исключена. Если psz параметр установлен на НЕДЕЙСТВИТЕЛЬНЫЙ, этот параметр проигнорирован.

iCodePage

Определяет кодовую страницу использованную, чтобы предоставлять строку. Эта величина должна быть или CP_WINANSI или CP_WINUNICODE.



Обратные Величины

Если psz параметр определял бы правильный указатель, обратная величина является длиной, в символах, возвращанного текста (не включая завершающий недействительный символ). Если psz параметр определял бы НЕДЕЙСТВИТЕЛЬНЫЙ указатель, обратная величина является длиной текста связанного hsz параметром (не включая завершающий недействительный символ). Если ошибка происходит, обратная величина является 0L.

Замечания

Строка возвращанная в буфер всегда недействительный расторгнутая. Если строка более длинная чем типы (cchMax - 1), только первая (cchMax - 1) строки скопированы.
Если psz параметр НЕДЕЙСТВИТЕЛЕН, функция DdeQueryString получает длину, в байтах, строки связанной ручкой строки. Длина не включает завершающий недействительный символ.

Смотри Также

DdeCmpStringHandles, DdeCreateStringHandle, DdeFreeStringHandle, DdeInitialize


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz