SafeArrayPtrOfIndex function

Gets a pointer to an array element.

Syntax


HRESULT SafeArrayPtrOfIndex(
  _In_  SAFEARRAY *psa,
  _In_  LONG      *rgIndices,
  _Out_ void      **ppvData
);

psa [in]: An array descriptor created by SafeArrayCreate.
rgIndices [in]: An array of index values that identify an element of the array. All indexes for the element must be specified.
ppvData [out]: The array element.

This function can return one of these values.

Return code	Description
S_OK	Success.
DISP_E_BADINDEX	The specified index is not valid.
E_INVALIDARG	One of the arguments is not valid.

The array should be locked before SafeArrayPtrOfIndex is called. Failing to lock the array can cause unpredictable results.