SLAcquireGenuineTicket 函数 (slpublic.h)

获取从软件许可服务器 (SLS) 获取的 XrML 正版票证。

语法

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

参数

[out] ppTicketBlob

指向接收票证 BLOB 的缓冲区的指针的地址。 使用此缓冲区后，通过调用 LocalFree 函数来释放该缓冲区。

[out] pcbTicketBlob

指向 ppTicketBlob 缓冲区的大小（以字节为单位）的指针。

[in] pwszTemplateId

指向以 null 结尾的字符串的指针，该字符串包含存储在 SLS 上的 BLOB 模板的 ID。

[in] pwszServerUrl

指向包含 SLS URL 的以 null 结尾的字符串的指针。

[in, optional] pwszClientToken

保留。

返回值

如果方法成功，则返回 S_OK。

如果方法失败，则返回错误代码。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	slpublic.h
Library	Slcext.lib
DLL	Slcext.dll