SafeArrayPtrOfIndex

9/8/2008

Essa função recupera um ponteiro para um elemento matriz.

Syntax

HRESULT SafeArrayPtrOfIndex(
SAFEARRAY FAR* psa, 
long FAR* rgIndices, 
void HUGEP* FAR* ppvData 
);

Parameters

• psa
  Ponteiro para uma descritor de matriz criado por SafeArrayCreate.

• rgIndices
  Matriz de valores índice que identifica um elemento da matriz. Todos os índices para o elemento devem ser especificados.

• ppvData
  Em retorno, ponteiro para void o ponteiro para o elemento identificado pelos valores em rgIndices.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Remarks

A matriz deve ser bloqueada antes SafeArrayPtrOfIndex é chamado. Falhando ao bloqueio de matriz pode causar resultados imprevisíveis.

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Requirements

See Also

Reference

Automation Functions
SafeArrayCreate
SafeArrayUnlock
SafeArrayLock