pr_openanonfilemap.rst (926B)
1 PR_OpenAnonFileMap 2 ================== 3 4 Creates or opens a named semaphore with the specified name 5 6 7 Syntax 8 ------ 9 10 .. code:: 11 12 #include <prshma.h> 13 14 NSPR_API( PRFileMap *) 15 PR_OpenAnonFileMap( 16 const char *dirName, 17 PRSize size, 18 PRFileMapProtect prot 19 ); 20 21 22 Parameters 23 ~~~~~~~~~~ 24 25 The function has the following parameters: 26 27 ``dirName`` 28 A pointer to a directory name that will contain the anonymous file. 29 ``size`` 30 The size of the shared memory. 31 ``prot`` 32 How the shared memory is mapped. 33 34 35 Returns 36 ~~~~~~~ 37 38 Pointer to :ref:`PRFileMap` or ``NULL`` on error. 39 40 41 Description 42 ----------- 43 44 If the shared memory already exists, a handle is returned to that shared 45 memory object. 46 47 On Unix platforms, :ref:`PR_OpenAnonFileMap` uses ``dirName`` as a 48 directory name, without the trailing '/', to contain the anonymous file. 49 A filename is generated for the name. 50 51 On Windows platforms, ``dirName`` is ignored.