SLAcquireGenuineTicket function

Gets a XrML genuine ticket acquired from the Software Licensing Server (SLS).

Syntax


HRESULT WINAPI SLAcquireGenuineTicket(
  _Out_    VOID   **ppTicketBlob,
  _Out_    UINT   *pcbTicketBlob,
  _In_     PCWSTR pwszTemplateId,
  _In_     PCWSTR pwszServerUrl,
  _In_opt_ PCWSTR pwszClientToken
);

Parameters

ppTicketBlob [out]

The address of a pointer to a buffer that receives the ticket BLOB. When you have finished using this buffer, free it by calling the LocalFree function.

pcbTicketBlob [out]

A pointer to the size, in bytes, of the ppTicketBlob buffer.

pwszTemplateId [in]

A pointer to a null-terminated string that contains the ID of the BLOB template stored on the SLS.

pwszServerUrl [in]

A pointer to a null-terminated string that contains the URL of the SLS.

pwszClientToken [in, optional]

Reserved.

Return value

If the method succeeds, it returns S_OK.

If the method fails, it returns an error code. For a list of common error codes, see Common HRESULT Values.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Slpublic.h

Library

Slcext.lib

DLL

Slcext.dll

 

 

Show: