SLAcquireGenuineTicket function (slpublic.h)

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

Syntax

HRESULT SLAcquireGenuineTicket(
  [out]          VOID   **ppTicketBlob,
  [out]          UINT   *pcbTicketBlob,
  [in]           PCWSTR pwszTemplateId,
  [in]           PCWSTR pwszServerUrl,
  [in, optional] PCWSTR pwszClientToken
);

Parameters

[out] ppTicketBlob

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.

[out] pcbTicketBlob

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

[in] pwszTemplateId

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

[in] pwszServerUrl

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

[in, optional] pwszClientToken

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