IPXS_PDFVariant::Arr_GetStringR Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
m (Automatic page editing by robot)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IPXS_PDFVariant::Arr_GetStringR Method}}
 
{{#customTitle:IPXS_PDFVariant::Arr_GetStringR Method}}
−
{{#parentPage:PXV:IPXS_PDFVariant|Arr_GetStringR Method|method}}
+
{{#parentPage:PXV:IPXS_PDFVariant#Methods|Arr_GetStringR|method}}
−
{{ToWrite}}
+
 
{{ToReview}}
 
{{ToReview}}
  
−
The method of interface of PDF-XChange Editor SDK.
+
The Returns the value of a specified element of an array as array of bytes (raw data from PDF). If specified element type is not <code>PVT_String</code> or index is out of range function return <code>S_FALSE</code> and <code>nLen</code> is set to '''0''' (zero).
  
 
== Syntax ==
 
== Syntax ==
 
<pre class="brush:cpp;gutter:false">HRESULT Arr_GetStringR([in]  ULONG  nIndex,
 
<pre class="brush:cpp;gutter:false">HRESULT Arr_GetStringR([in]  ULONG  nIndex,
−
                       [out]  UCHAR*  pBuf,
+
                       [out]  UCHAR*  nBuf,
 
                       [in]  ULONG  nBufLen,
 
                       [in]  ULONG  nBufLen,
−
                       [out]  ULONG*  pLen);</pre>
+
                       [out]  ULONG*  nLen);</pre>
  
 
== Parameters ==
 
== Parameters ==
 
;nIndex
 
;nIndex
−
:[in] Value of ULONG.
+
:[in] Specifies the index of the array element.
−
;pBuf
+
;nBuf
−
:[out] Pointer to UCHAR.
+
:[out] Pointer to UCHAR buffer, to which string data will be copied. If it is <code>NULL</code> no data copying required and <code>nLen</code> will receive size of raw data. If both of these pointers are <code>NULL</code> function will return <code>E_INVALIDARG</code>.
 
;nBufLen
 
;nBufLen
−
:[in] Value of ULONG.
+
:[in] Specify maximum size of raw data to be copied.
−
;pLen
+
;nLen
−
:[out] Pointer to ULONG.
+
:[out] Pointer to variable which receive raw data size (always, even when function copy some data into buffer with truncation).  
  
 
== Return Value ==
 
== Return Value ==
Line 27: Line 27:
  
 
== See Also ==
 
== See Also ==
−
See also [[PXV:IPXS_PDFVariant|IPXS_PDFVariant]].
+
[[PXV:IPXS_PDFVariant|IPXS_PDFVariant]]

Latest revision as of 03:42, 15 June 2015

PDF Structures Layer > Interfaces > IPXS_PDFVariant > IPXS_PDFVariant::Arr_GetStringR Method


The Returns the value of a specified element of an array as array of bytes (raw data from PDF). If specified element type is not PVT_String or index is out of range function return S_FALSE and nLen is set to 0 (zero).

Syntax

HRESULT Arr_GetStringR([in]   ULONG   nIndex,
                       [out]  UCHAR*  nBuf,
                       [in]   ULONG   nBufLen,
                       [out]  ULONG*  nLen);

Parameters

nIndex
[in] Specifies the index of the array element.
nBuf
[out] Pointer to UCHAR buffer, to which string data will be copied. If it is NULL no data copying required and nLen will receive size of raw data. If both of these pointers are NULL function will return E_INVALIDARG.
nBufLen
[in] Specify maximum size of raw data to be copied.
nLen
[out] Pointer to variable which receive raw data size (always, even when function copy some data into buffer with truncation).

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXS_PDFVariant

Retrieved from "https://sdkhelp.pdf-xchange.com/index.php?title=PXV:IPXS_PDFVariant_Arr_GetStringR&oldid=45364"