please dont rip this site Prev Next

LSGetMessage info  Overview  Group

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 

file: /Techref/os/win/api/win32/func/src/f55_15.htm, 5KB, , updated: 2000/4/7 11:19, local time: 2024/11/25 15:37,
TOP NEW HELP FIND: 
3.145.155.149:LOG IN
 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://sxlist.com/TECHREF/os/win/api/win32/func/src/f55_15.htm"> LSGetMessage</A>
After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?
 

Welcome to sxlist.com!

Site supported by
sales, advertizing,
& kind contributors
just like you!
Please don't rip/copy
(here's why
Copies of the site on CD
are available at minimal cost.
 

Welcome to sxlist.com!

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  .