SLGatherMigrationBlob function (slpublic.h)

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