SafeArrayPtrOfIndex-Funktion (oleauto.h)

Ruft einen Zeiger auf ein Arrayelement ab.

Syntax

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

Parameter

[in] psa

Ein arraydeskriptor, der von SafeArrayCreate erstellt wurde.

[in] rgIndices

Ein Array von Indexwerten, die ein Element des Arrays identifizieren. Alle Indizes für das -Element müssen angegeben werden.

[out] ppvData

Das Arrayelement.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
DISP_E_BADINDEX	Der angegebene Index ist ungültig.
E_INVALIDARG	Eines der Argumente ist ungültig.

Hinweise

Das Array sollte gesperrt werden, bevor SafeArrayPtrOfIndex aufgerufen wird. Wenn das Array nicht gesperrt wird, kann dies zu unvorhersehbaren Ergebnissen führen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	oleauto.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll