IByteBuffer::Initialize-Methode
[Die Initialize-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher verfügbar. Die IStream-Schnittstelle bietet ähnliche Funktionen.]
Die Initialize-Methode bereitet das IByteBuffer-Objekt für die Verwendung vor. Diese Methode muss aufgerufen werden, bevor andere Methoden in der IByteBuffer-Schnittstelle aufgerufen werden.
Syntax
HRESULT Initialize(
[in] LONG lSize,
[in] BYTE *pData
);
Parameter
-
lSize [ In]
-
Die Anfangsgröße der Daten, die der Stream enthalten soll, in Bytes.
-
pData [ In]
-
Wenn nicht NULL, die anfänglichen Daten, die in den Stream geschrieben werden sollen.
Rückgabewert
Der Rückgabewert ist ein HRESULT. Der Wert S _ OK gibt an, dass der Aufruf erfolgreich war.
Bemerkungen
Wenn Sie einen neuen IByteBuffer-Stream verwenden, rufen Sie diese Methode auf, bevor Sie eine der anderen IByteBuffer-Methoden verwenden.
Beispiele
Das folgende Beispiel zeigt die Initialisierung des IByteBuffer-Objekts.
UCHAR ucFileName[] = {0x3f, 0x00}; // Master File (MF)
HRESULT hr;
// pIByteRequest is a pointer to an instantiated IByteBuffer object.
hr = pIByteRequest->Initialize(2, ucFileName);
if (FAILED(hr))
printf("Failed IByteBuffer::Initialize\n");
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ IByteBuffer ist als E126F8FE-A7AF-11D0-B88A-00C04FD424B9 definiert. |