ILockBytes::SetSize-Methode (objidl.h)

  • Artikel

Die SetSize-Methode ändert die Größe des Bytearrays.

Syntax

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Parameter

[in] cb

Gibt die neue Größe des Bytearrays als Anzahl von Bytes an.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Die Größe des Bytearrays wurde erfolgreich geändert.
STG_E_ACCESSDENIED Der Aufrufer verfügt nicht über die Berechtigung für den Zugriff auf das Bytearray.
STG_E_MEDIUMFULL Die Bytearraygröße wird nicht geändert, da auf dem Speichergerät kein Speicherplatz mehr vorhanden ist.

Hinweise

ILockBytes::SetSize ändert die Größe des Bytearrays. Wenn der cb-Parameter größer als das aktuelle Bytearray ist, wird das Bytearray auf die angegebene Größe erweitert, indem der dazwischenliegende Leerraum mit Bytes mit nicht definiertem Wert gefüllt wird, ebenso wie ILockBytes::WriteAt, wenn der Suchzeiger am aktuellen Ende des Datenstroms vorbei ist.

Wenn der cb-Parameter kleiner als das aktuelle Bytearray ist, wird das Bytearray auf die angegebene Größe abgeschnitten.

Hinweise für Anrufer

Aufrufer können sich nicht darauf verlassen, dass STG_E_MEDIUMFULL aufgrund des Cachepuffers im Betriebssystem oder Netzwerk zum geeigneten Zeitpunkt zurückgegeben werden. Aufrufer müssen jedoch in der Lage sein, mit diesem Rückgabecode umzugehen, da ihn möglicherweise einige ILockBytes-Implementierungen unterstützen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h
Bibliothek Uuid.lib
DLL Ole32.dll

Weitere Informationen

ILockBytes – File-Based Implementierung

ILockBytes – Globale Speicherimplementierung

ILockBytes::ReadAt

ILockBytes::WriteAt