Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 8
Allocate a buffer and pack transport data into it
char * PhAllocPackType( char unsigned *type,
char unsigned *desc,
int unsigned grouping_num,
int unsigned handle,
int unsigned transport,
char *packing_type,
char unsigned *data,
int unsigned len,
int *size );
- type
- A descriptive type name, such as image, text,
filename, or files.
This is simply added to the header for the packed data.
- desc
- The specifics of what's in the data.
The extractor uses a regular-expression match against the description to
determine if the data should be unpacked or discarded.
This is simply added to the header for the packed data.
- grouping_num
- When used with Photon's drag and drop mechanism, the
grouping_num is used to indicate which stream is just a
different representation of other data also packed into the same
PhTransportCtrl_t
structure.
Only one of each grouping_num should be unpacked by the
reader/destination.
This value is simply added to the header for the packed data.
- handle
- A number that you can use to identify a transaction.
This is simply added to the header for the packed data.
- transport
- The transport type used for the inlined data. This can be one of:
- Ph_TRANSPORT_INLINE — the data being transported
is in memory and can be unpacked immediately.
- Ph_TRANSPORT_FILEREF — the data being transported
is in the temporary file(s) named in the inlined data.
- Ph_TRANSPORT_SHMEM — the data being transported
is in the temporary shared object(s) named in the inlined data.
- packing_type
- The name of the entry in the transport registry to be used to pack
the data.
For more information, see
PhTransportRegEntry_t.
If you already have a pointer to the registry entry, you can call
PhPackEntry()
instead of PhPackType().
- data
- A pointer to the data to be packed.
- len
- The size, in bytes, of the data to be packed.
This size is used only for raw data.
- size
- If this argument isn't NULL, the size of the allocated
buffer is stored in the memory it points to.
ph
This function allocates a buffer big enough to hold the packed version of
the given data, and then packs the data into the buffer.
A pointer to the buffer, or NULL if no data was packed.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
PhMallocUnpack(),
PhPackEntry(),
PhPackType(),
PhTransportCtrl_t,
PhTransportRegEntry_t,
PhTransportType(),
PhUnpack()
Drag and Drop
chapter of the Photon Programmer's Guide
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 186
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ph/phallocpacktype.html on line 186