Função SafeArrayPtrOfIndex (oleauto.h)

Obtém um ponteiro para um elemento de matriz.

Sintaxe

HRESULT SafeArrayPtrOfIndex(
  [in]  SAFEARRAY *psa,
  [in]  LONG      *rgIndices,
  [out] void      **ppvData
);

[in] psa

Um descritor de matriz criado por SafeArrayCreate.

[in] rgIndices

Uma matriz de valores de índice que identificam um elemento da matriz. Todos os índices do elemento devem ser especificados.

[out] ppvData

O elemento de matriz.

Essa função pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
DISP_E_BADINDEX	O índice especificado não é válido.
E_INVALIDARG	Um dos argumentos não é válido.

A matriz deve ser bloqueada antes que SafeArrayPtrOfIndex seja chamado. Falha ao bloquear a matriz pode causar resultados imprevisíveis.