ISCardTypeConv::ConvertSafeArrayToByteBuffer-Methode

[Die ConvertSafeArrayToByteBuffer-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 ConvertSafeArrayToByteBuffer-Methode konvertiert ein Bytearray, das als SAFEARRAY definiert ist, in einen universellen Bytepuffer (IStream-Objekt).

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 Arrayimplementierungen ist, dass beim Aufrufen der IStream::Release-Methode der zugrunde liegende Arbeitsspeicher für Sie freigegeben wird.

Syntax

HRESULT ConvertSafeArrayToByteBuffer(
  [in]  LPSAFEARRAY  pbyArray,
  [out] LPBYTEBUFFER *ppbyBuff
);

Parameter

pbyArray [ In]

Zeiger auf das SAFEARRAY, das konvertiert werden soll.

ppbyBuff [ out]

Zeiger auf das IStream-Objekt, das zurückgegeben werden soll.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück:

Rückgabecode Beschreibung
S _ OK
Arbeitsspeicher wurde erfolgreich zugeordnet.
E _ INVALIDARG
Es liegt ein Problem mit einem oder mehreren parametern vor, die an die Funktion übergeben werden.
E _ POINTER
Ein Parameter vom Zeigertyp war falsch.
E _ OUTOFMEMORY
Nicht genügend freier Arbeitsspeicher zum Erfüllen der Anforderung.

Hinweise

Der zugeordnete Arbeitsspeicher kann verschoben werden. Verwenden Sie die IStream::Release-Methode, um den Arbeitsspeicher freizugeben.

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
Ddat.h
Typbibliothek
Ddat.tlb
DLL
Scardssp.dll
IID
IID _ ISCardTypeConv ist als 53B6AA63-3F56-11D0-916B-00AA00C18068 definiert.

Siehe auch

ISCardTypeConv

Smartcard-Rückgabewerte