Edit

Share via

SLGatherMigrationBlob function (slpublic.h)

  • Article

Gathers licensing information for the provided file handle. This licensing information
can later be applied or deposited using the SLDepositMigrationBlob function.

Syntax

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

Parameters

[in] bMigratableOnly

Type: BOOL

TRUE if only data that can be migrated should be gathered; FALSE otherwise.

[in, optional] pwszEncryptorUri

Type: LPCWSTR

The URI of the encrypting session key used to encrypt
any sensitive data in the output BLOB. Only valid values are NULL and SL_DEFAULT_MIGRATION_ENCRYPTOR_URI,
which both refer to the same key.

[in] hFile

Type: HANDLE

The handle to the file where the licensing state BLOB should be written.

Return value

Type: HRESULT WINAPI

If this function succeeds, it return S_OK. Otherwise, it returns an HRESULT error code.

Return code/value Description
E_INVALIDARG
0x80070057
 One or more arguments are not valid.
E_ACCESSDENIED
0x80070005
 Access denied (API requires admin privileges).

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header slpublic.h
Library Slc.lib
DLL Slc.dll