ILockBytes::ReadAt-Methode (objidl.h)
Die ReadAt-Methode liest eine angegebene Anzahl von Bytes, beginnend bei einem angegebenen Offset vom Anfang des Bytearrayobjekts.
Syntax
HRESULT ReadAt(
[in] ULARGE_INTEGER ulOffset,
[in] void *pv,
[in] ULONG cb,
[out] ULONG *pcbRead
);
Parameter
[in] ulOffset
Gibt den Ausgangspunkt vom Anfang des Bytearrays zum Lesen von Daten an.
[in] pv
Zeiger auf den Puffer, in den das Bytearray gelesen wird. Die Größe dieses Puffers ist in cb enthalten.
[in] cb
Gibt die Anzahl der Bytes an, die versucht werden sollen, aus dem Bytearray zu lesen.
[out] pcbRead
Zeiger auf einen ULONG-Wert , in dem diese Methode die tatsächliche Anzahl von Bytes schreibt, die aus dem Bytearray gelesen werden. Sie können diesen Zeiger auf NULL festlegen, um anzugeben, dass Sie an diesem Wert nicht interessiert sind. In diesem Fall stellt diese Methode nicht die tatsächliche Anzahl der gelesenen Bytes bereit.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Gibt an, dass die angegebene Anzahl von Bytes gelesen oder die maximale Anzahl von Bytes am Ende des Bytearrays gelesen wurde. |
| E_FAIL | Daten konnten nicht aus dem Bytearray gelesen werden. |
| E_PENDING | Nur asynchroner Speicher: Ein Teil oder alle zu lesenden Daten sind derzeit nicht verfügbar. |
| STG_E_ACCESSDENIED | Der Aufrufer verfügt nicht über die Berechtigung für den Zugriff auf das Bytearray. |
| STG_E_READFAULT | Die Anzahl der zu lesenden Bytes entspricht nicht der Anzahl der Bytes, die tatsächlich gelesen wurden. |
Hinweise
ILockBytes::ReadAt liest Bytes aus dem Bytearrayobjekt. Sie meldet die Anzahl der Bytes, die tatsächlich gelesen wurden. Dieser Wert kann kleiner als die Anzahl der angeforderten Bytes sein, wenn ein Fehler auftritt oder das Ende des Bytearrays während des Lesevorgangs erreicht wird.
Es ist kein Fehler, weniger als die angegebene Anzahl von Bytes zu lesen, wenn der Vorgang auf das Ende des Bytearrays trifft. Beachten Sie, dass dies dasselbe Verhalten am Dateiende ist, das auch in MS-DOS-Dateisystemdateien für die Dateizuordnungstabelle (FAT) zu finden ist.
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