Condividi tramite


Metodo ISCardTypeConv::ConvertByteArrayToByteBuffer

[Il metodo ConvertByteArrayToByteBuffer è 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 ConvertByteArrayToByteBuffer converte una tipica matrice di byte C/C++ in un buffer universale di byte (oggetto IStream ).

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 ConvertByteArrayToByteBuffer(
  [in]  LPBYTE       pbyArray,
  [in]  DWORD        dwArraySize,
  [out] LPBYTEBUFFER *ppbyBuffer
);

Parametri

pbyArray [in]

Puntatore alla matrice di byte da convertire.

dwArraySize [in]

Dimensioni della matrice di byte da convertire.

ppbyBuffer [out]

Puntatore all'oggetto IStream da restituire.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti:

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

 

Commenti

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

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