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