Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Die CreateByteBuffer-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, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]
Die CreateByteBuffer-Methode erstellt einen universellen Puffer von Bytes, die einem IStream-Objekt (IByteBuffer) zugeordnet sind.
Der erstellte Bytepuffer ist ein Stream, der einem Speicherblock zugeordnet ist. Verwenden Sie die von der IStream-Schnittstelle bereitgestellten Methoden, um auf den Puffer zuzugreifen oder diesen zu verwalten. Ein einzigartiges Feature dieser Arrayimplementierung ist, dass beim Aufrufen der IStream::Release-Methode der zugrunde liegende Arbeitsspeicher für Sie freigegeben wird.
Syntax
HRESULT CreateByteBuffer(
[in] DWORD dwAllocSize,
[out] LPBYTEBUFFER *ppbyBuff
);
Parameter
-
dwAllocSize [in]
-
Größe in Bytes des Speichers, der für das Array zugewiesen werden soll.
-
ppbyBuff [out]
-
Zeiger auf das zurückzugebende IStream-Objekt.
Rückgabewert
Folgende Rückgabewerte sind möglich:
| Rückgabecode | Beschreibung |
|---|---|
|
Arbeitsspeicher wurde erfolgreich zugewiesen. |
|
Es stimmt etwas nicht mit einem oder mehreren parametern, die an die Funktion übergeben werden. |
|
Nicht genügend freier Arbeitsspeicher, um die Anforderung zu erfüllen. |
Bemerkungen
Der zugewiesene Arbeitsspeicher ist verschiebbar. Verwenden Sie die IStream::Release-Methode , um den Arbeitsspeicher freizugeben.
Um ein typisches C/C++-Bytearray zu erstellen, rufen Sie CreateByteArray auf.
Rufen Sie CreateSafeArray auf, um ein Automation SAFEARRAY mit zeichenlosen Zeichen (Bytes) zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCardTypeConv ist definiert als 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Weitere Informationen