slGatherMigrationBlob 函数 (slpublic.h)

收集所提供文件句柄的许可信息。此许可信息
稍后可以使用 SLDepositMigrationBlob 函数应用或存入。

语法

HRESULT SLGatherMigrationBlob(
  [in]           BOOL    bMigratableOnly,
  [in, optional] LPCWSTR pwszEncryptorUri,
  [in]           HANDLE  hFile
);

[in] bMigratableOnly

类型： BOOL

如果仅应收集可迁移的数据，则为 TRUE;否则为 FALSE。

[in, optional] pwszEncryptorUri

类型： LPCWSTR

用于加密的加密会话密钥的 URI
输出 BLOB 中的任何敏感数据。只有有效的值为 NULL 和 SL_DEFAULT_MIGRATION_ENCRYPTOR_URI，
这两者都引用同一个键。

[in] hFile

类型： HANDLE

应在其中写入许可状态 BLOB 的文件的句柄。

类型： HRESULT WINAPI

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

返回代码/值	说明
E_INVALIDARG 0x80070057	一个或多个参数无效。
E_ACCESSDENIED 0x80070005	拒绝访问 (API 需要管理员权限) 。