ILockBytes::SetSize-Methode (objidl.h)
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