Condividi tramite


Metodo ISCardTypeConv::CreateByteBuffer

[Il metodo CreateByteBuffer è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. I moduli smart card offrono funzionalità simili.

Il metodo CreateByteBuffer crea un buffer universale di byte mappato in un oggetto IStream (IByteBuffer).

Il buffer di byte creato è un flusso mappato a un blocco di memoria. Per accedere o gestire il buffer, usare i metodi forniti dall'interfaccia IStream . Una funzionalità univoca di questa implementazione della matrice è che quando si chiama il metodo IStream::Release , la memoria sottostante verrà rilasciata per l'utente.

Sintassi

HRESULT CreateByteBuffer(
  [in]  DWORD        dwAllocSize,
  [out] LPBYTEBUFFER *ppbyBuff
);

Parametri

dwAllocSize [in]

Dimensioni in byte della memoria da allocare per la matrice.

ppbyBuff [out]

Puntatore all'oggetto IStream da restituire.

Valore restituito

I valori restituiti possibili sono i seguenti:

Codice restituito Descrizione
S_OK
Memoria allocata correttamente.
E_INVALIDARG
C'è qualcosa di sbagliato con uno o più parametri passati alla funzione.
E_OUTOFMEMORY
Memoria insufficiente per soddisfare la richiesta.

 

Commenti

La memoria allocata è rimovibile. Usare il metodo IStream::Release per liberare la memoria.

Per creare una matrice di byte C/C++ tipica, chiamare CreateByteArray.

Per creare un'automazione SAFEARRAY di caratteri non firmati (byte), chiamare CreateSafeArray.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Fine del supporto client
Windows XP
Fine del supporto server
Windows Server 2003
Intestazione
Scarddat.h
Libreria dei tipi
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardTypeConv è definito come 53B6A63-3F56-11D0-916B-00AA0C18068

Vedi anche

ISCardTypeConv

Valori restituiti da smart card

CreateByteArray

CreateSafeArray