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