Registers a function to demigrate files.
#include <zMigrate.h> STATUS zRegisterDemigrateFunction( DemigrateFunc_t demigrateFunction);
(IN) Specifies the demigrate function. NSS calls this function when you ask it to access the data for a migrated file.
|
zOK |
The operation completed successfully. |
|
zERR_DEMIGRATE_ ALREADY_REGISTERED |
A demigration function has been registered. Only one demigrator can reside in the system at a time. |
When you request that NSS access the data portion of a migrated file, NSS calls the demigration function. After the demigration function returns, NSS expects the data to be demigrated and begins accessing the data.
The key parameter that is passed to the demigration function can be used with the File System Services functions to demigrate a file. Call zWrite to write the demigrated data back to the data stream. After the demigrated function returns, the key parameter is cleaned up.