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 錯誤碼。

傳回碼/值	Description
E_INVALIDARG 0x80070057	一或多個自變數無效。
E_ACCESSDENIED 0x80070005	拒絕存取 (API 需要系統管理員許可權) 。