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.

Requirements