IPXS_PDFVariant::Arr_GetName Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
m (Automatic page editing by robot)
Line 5: Line 5:
 
{{ToReview}}
 
{{ToReview}}
  
The Returns the value of a specified element of an array as an unicode string ('''BSTR'''). If specified element type is not <code>PVT_Name</code> <code>sDefVal</code> is returned.
+
The Returns the value of a specified element of an array as an unicode string ('''BSTR'''). If specified element type is not <code>PVT_Name</code> <code>DefVal</code> is returned.
  
 
== Syntax ==
 
== Syntax ==
<pre class="brush:cpp;gutter:false">HRESULT Arr_GetName([in]          ULONG  nIndex,
+
<pre class="brush:cpp;gutter:false">HRESULT Arr_GetName([in]          ULONG  Index,
                     [in]          BSTR  sDefVal,
+
                     [in]          BSTR  DefVal,
                     [out, retval]  BSTR*  sVal);</pre>
+
                     [out, retval]  BSTR*  Val);</pre>
  
 
== Parameters ==
 
== Parameters ==
;nIndex
+
;Index
 
:[in] Specifies the index of the array element.
 
:[in] Specifies the index of the array element.
;sDefVal
+
;DefVal
 
:[in] Default value that will be returned when specified index is out of range or the element type is not <code>PVT_Name</code>.
 
:[in] Default value that will be returned when specified index is out of range or the element type is not <code>PVT_Name</code>.
;sVal
+
;Val
 
:[out, retval]  Pointer to BSTR that receives the returned value.
 
:[out, retval]  Pointer to BSTR that receives the returned value.
  
 
== Return Value ==
 
== Return Value ==
Returns S_OK if operation was successful or error code in other cases. Returns S_FALSE when <code>sDefVal</code> returned.
+
Returns S_OK if operation was successful or error code in other cases. Returns S_FALSE when <code>DefVal</code> returned.
  
 
== See Also ==
 
== See Also ==
 
[[PXV:IPXS_PDFVariant|IPXS_PDFVariant]]
 
[[PXV:IPXS_PDFVariant|IPXS_PDFVariant]]

Revision as of 07:18, 12 June 2015


The Returns the value of a specified element of an array as an unicode string (BSTR). If specified element type is not PVT_Name DefVal is returned.

Syntax

HRESULT Arr_GetName([in]           ULONG  Index,
                    [in]           BSTR   DefVal,
                    [out, retval]  BSTR*  Val);

Parameters

Index
[in] Specifies the index of the array element.
DefVal
[in] Default value that will be returned when specified index is out of range or the element type is not PVT_Name.
Val
[out, retval] Pointer to BSTR that receives the returned value.

Return Value

Returns S_OK if operation was successful or error code in other cases. Returns S_FALSE when DefVal returned.

See Also

IPXS_PDFVariant