IByteBuffer::Initialize-Methode

[Die Initialize-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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 zur Verwendung vor. Diese Methode muss vor dem Aufrufen anderer Methoden in der IByteBuffer-Schnittstelle aufgerufen werden.

Syntax

HRESULT Initialize(
  [in] LONG lSize,
  [in] BYTE *pData
);

Parameter

lSize [in]

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");

Anforderungen