На главную

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

LSGetMessage



Notice:This is preliminary documentation for technology that will be supported in future releases of Microsoft Windows.

The LSGetMessage function returns the message string associated with a license service function status code.

LS_STATUS_CODE LS_API_ENTRY LSGetMessage(

LS_HANDLE LicenseHandle, // handle to the license context
LS_STATUS_CODE Value, // any status code returned by a license service function
LS_STR *Buffer, // pointer to buffer returning error message string
LS_ULONG BufferSize // maximum size of buffer string
);


Parameters

LicenseHandle

[in] Specifies the handle to the license context. This parameter must be a handle created with the LSRequest function.

Value

[in] Specifies any status code returned by a license service function.

Buffer

[out] Points to a buffer in which a localized error message string will be returned.

BufferSize

[in] Specifies, in bytes, the maximum size of the string returned in the Buffer parameter.



Return Values

If the function succeeds, the return value is LS_SUCCESS.
If the function fails, the return value is a status code. For extended error information, call LSGetMessage to return the status text corresponding to the status code. The LSGetMessage function may return one of the following status codes:

Value Meaning
LS_BAD_HANDLE The handle used on the call does not describe a valid licensing system context.
LS_RESOURCES_UNAVAILABLE The request cannot be completed because of insufficient resources, such as memory.
LS_TEXT_UNAVAILABLE A warning occurred while looking up an error message string with the LSGetMessage function.
LS_UNKNOWN_STATUS An unrecognized status code was passed to the LSGetMessage function.
LS_BUFFER_TOO_SMALL The buffer that the Buffer parameter points to is too small to accommodate the text string to be returned; or the challenge data structure is too small to accommodate the challenge response.
LS_BAD_ARG One or more of the arguments is incorrect.


Remarks

The LSGetMessage function returns a string describing a specific error, and possibly a suggested action to be taken in response to it. If the value specified in the Value parameter is the constant LS_USE_LAST, then the last error associated with the supplied licensing handle, plus its associated data, is returned. Otherwise, the function uses the supplied error code.

See Also

LSRequest


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

LSGetMessage



Уведомление:Это - предварительная документация для технологии, которая будет поддержана в будущих версиях Microsoft Windows.

Функция LSGetMessage возвращает строку сообщения связанную функциональным статусом лицензионного кода услуги.

LS_STATUS_CODE LS_API_ENTRY LSGetMessage(

LS_HANDLE LicenseHandle, // ручка в лицензионную контекстную Величину LS_STATUS_CODE, // любой код статуса возвращанные лицензионной функцией услуги LS_STR *Буфер, // указатель, чтобы буферизовать строку сообщения ошибки максимального размера возврата LS_ULONG BufferSize // буферной строки
);


Параметры

LicenseHandle

[in] Определяет ручку в лицензионный контекст. Этот параметр должен быть ручкой созданной функцией LSRequest.

Величина

[in] Определяет любой код статуса возвращанный лицензионной функцией услуги.

Буфер

[out] Указывает на буфер в котором строка сообщения локализованной ошибки будет возвращана.

BufferSize

[in] Определяет, в байтах, максимальный размер строки возвращался в параметр Буфера.



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

Если функция добивается успеха, обратная величина - LS_SUCCESS.
Если функция терпит неудачу, обратная величина является кодом статуса. Для расширенной информации ошибки, вызов LSGetMessage, чтобы возвращать текст статуса, соответствуемый в код статуса. Функция LSGetMessage может возвращать один из следующих кодов статуса:

Значение Величины
LS_BAD_HANDLE ручка использовалась на вызове не описывает правильный лицензионный системный контекст.
LS_RESOURCES_UNAVAILABLE запрос не может быть завершен из-за недостаточных ресурсов, как например, память.
LS_TEXT_UNAVAILABLE предупреждение происходило ища строку сообщения ошибки с функцией LSGetMessage.
LS_UNKNOWN_STATUS неузнанный код статуса был пройден в функцию LSGetMessage.
LS_BUFFER_TOO_SMALL буфер, что параметр Буфера указывает, чтобы слишком небольшое, чтобы размещать текстовую строку, чтобы быть возвращанн; или структура данных вызова слишком небольшая, чтобы размещать ответ вызова.
LS_BAD_ARG Один или более из аргументов неправильное.


Замечания

Функция LSGetMessage возвращает строку, описывающую специфическую ошибку, и возможно предложенное действие, которое нужно требоваться в ответ на это. Если величина определенная в параметре Величины - константа LS_USE_LAST, тогда последняя ошибка связанная поставленным лицензированием ручки, плюс свои связанные данные, возвращана. В противном случае, функция использует поставленный код ошибки.

Смотри Также

LSRequest


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