Freigeben über


ISCardTypeConv::CreateByteBuffer-Methode

[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
S_OK
Arbeitsspeicher wurde erfolgreich zugewiesen.
E_INVALIDARG
Es stimmt etwas nicht mit einem oder mehreren parametern, die an die Funktion übergeben werden.
E_OUTOFMEMORY
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
Scarddat.h
Typbibliothek
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardTypeConv ist definiert als 53B6AA63-3F56-11D0-916B-00AA00C18068

Weitere Informationen

ISCardTypeConv

Smartcard-Rückgabewerte

CreateByteArray

CreateSafeArray