comment: <> (pmem2_source_get_handsle.3 – man page for pmem2_source_get_handle
pmem2_source_get_handle() - reads file handler of the data source
#include <libpmem2.h> int pmem2_source_get_handle(const struct pmem2_source *src, HANDLE *h);
The pmem2_source_get_handle() function reads the file handler of struct pmem2_source* object describing the data source and returns it by h parameter.
This function is Windows only, on Linux use pmem2_source_get_fd(3). If the source was created using pmem2_source_from_fd(3) then pmem2_source_get_handle() is also valid function to read handler, because file descriptor is converted to file handle during source creation.
However, there are limitations to what you can do with a handle created from a file descriptor. For details refer to DESCRIPTION section in the pmem2_source_from_fd(3) manpage.
The pmem2_source_get_handle() can fail with the following errors:
The pmem2_source_get_handle() returns a file handle of data source.
pmem2_source_from_fd(3), pmem2_source_get_fd(3), libpmem2(7) and http://pmem.io
The contents of this web site and the associated GitHub repositories are BSD-licensed open source.