На главную

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 | Скачать Вниз

DdeCreateStringHandle



The DdeCreateStringHandle function creates a handle that identifies the string pointed to by the psz parameter. A dynamic data exchange (DDE) client or server application can pass the string handle as a parameter to other Dynamic Data Exchange Management Library (DDEML) functions.

HSZ DdeCreateStringHandle(

DWORD idInst, // instance identifier
LPTSTR psz, // pointer to null-terminated string
int iCodePage // code page identifier
);


Parameters

idInst

Specifies the application instance identifier obtained by a previous call to the DdeInitialize function.

psz

Points to a buffer that contains the null-terminated string for which a handle is to be created. This string may be up to 255 characters. The reason for this limit is that DDEML string management functions are implemented using global atoms.

iCodePage

Specifies the code page used to render the string. This value should be either CP_WINANSI (the default code page) or CP_WINUNICODE, depending on whether the ANSI or Unicode version of DdeInitialize was called by the client application.



Return Values

If the function succeeds, the return value is a string handle.
If the function fails, the return value is 0L.

Errors

The DdeGetLastError function can be used to get the error code, which may be one of the following values:
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
DMLERR_SYS_ERROR

Remarks

The value of a string handle is not related to the case of the string it identifies.
When an application either creates a string handle or receives one in the callback function and then uses the DdeKeepStringHandle function to keep it, the application must free that string handle when it is no longer needed.
An instance-specific string handle cannot be mapped from string handle to string and back to string handle. This is shown in the following example, in which the DdeQueryString function creates a string from a string handle and DdeCreateStringHandle creates a string handle from that string, but the two handles are not the same:

DWORD idInst;
DWORD cb;
HSZ hszInst, hszNew;
PSZ pszInst;

DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI);
hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI);
// hszNew != hszInst !


See Also

DdeAccessData, DdeCmpStringHandles, DdeFreeStringHandle, DdeInitialize, DdeKeepStringHandle, DdeQueryString


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

DdeCreateStringHandle



Функция DdeCreateStringHandle создает ручку, которая идентифицирует строку указывался, чтобы psz параметром. Динамический обмен данных клиента (DDE) или приложение сервера может передать ручку строки как параметр на другое Биржевое Управление Динамической Библиотеки Данных (DDEML) функционирует.

HSZ DdeCreateStringHandle(

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


Параметры

idInst

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

psz

Точки на буфер, которые содержат недействительный расторгнутую строку для которой ручка должна быть создана. Эта строка может быть вплоть до 255 символов. Причина этого предела -, что функции управления строки DDEML осуществлены используя глобальные атомы.

iCodePage

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



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

Если функция добивается успеха, обратная величина является ручкой строки.
Если функция терпит неудачу, обратная величина является 0L.

Ошибки

Функция DdeGetLastError может быть использована, чтобы получать код ошибки, который может быть одним из следующего величин: DMLERR_INVALIDPARAMETER DMLERR_NO_ERROR DMLERR_SYS_ERROR

Замечания

Величина ручки строки - не имело отношение к случаю строки это идентифицируется.
Когда приложение или создает ручку строки или получает один в функции возврата затем использует функцию DdeKeepStringHandle, чтобы держать это, приложение должно освободить эту ручку строки когда оно не - больше не нужно.
Пример-специфическая ручка строки не может быть отображена из ручки строки, чтобы нанизывать и, чтобы нанизывать ручку. Это показан в следующем примере, в котором функция DdeQueryString создает строку из ручки строки и DdeCreateStringHandle создает ручку строки из этой строки, но две ручки - не тот же:

DWORD idInst;
cb DWORD;
HSZ hszInst, hszNew;
PSZ pszInst;

DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI);
hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI);
// hszNew != hszInst!


Смотри Также

DdeAccessData, DdeCmpStringHandles, DdeFreeStringHandle, DdeInitialize, DdeKeepStringHandle, DdeQueryString


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