SafeArrayRedim

  • Artikel

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Änderungen der ganz rechts (niederwertigsten) eines sicheren Arrays gebunden.

HRESULT SafeArrayRedim(  
  SAFEARRAY *psa,              
  SAFEARRAYBOUND *psaboundNew  
);

Parameter

  • psa
    Zeiger auf ein Arraydeskriptor.

  • psaboundNew
    Zeiger auf ein neues sicheren Array gebunden Struktur, die die neuen Array-Grenze enthält. Sie können nur die niederwertigste Dimension eines Arrays ändern.

Rückgabewert

Der Rückgabewert vom zurückgegebenen HRESULT ist eine der folgenden.

Wert

Bedeutung

S_OK

Erfolg.

DISP_E_ARRAYISLOCKED

Das Array ist momentan gesperrt.

E_INVALIDARG

Das Element auf psa verweist, ist kein sicheres Arraydeskriptor.

Kommentare

Wenn Sie die Grenze des Arrays verringern, freigibt SafeArrayRedim die Arrayelemente außerhalb der neuen Array-Grenze. Wenn die Grenze des Arrays erhöht wird, wird SafeArrayRedim reserviert und initialisiert die neue Arrayelemente. Die Daten ist für Elemente beibehalten, die in die alten und neuen Array vorhanden sind.