Metodo ISCardTypeConv::ConvertSafeArrayToByteBuffer
[Il metodo ConvertSafeArrayToByteBuffer è 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 ConvertSafeArrayToByteBuffer converte una matrice di byte definita come SAFEARRAY in un buffer universale di byte (oggetto IStream ).
Il buffer di byte creato è un flusso mappato su 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 ConvertSafeArrayToByteBuffer(
[in] LPSAFEARRAY pbyArray,
[out] LPBYTEBUFFER *ppbyBuff
);
Parametri
-
pbyArray [in]
-
Puntatore a SAFEARRAY da convertire.
-
ppbyBuff [out]
-
Puntatore all'oggetto IStream da restituire.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Memoria allocata correttamente. |
|
C'è qualcosa di sbagliato con uno o più parametri passati alla funzione. |
|
Un parametro di tipo puntatore non è corretto. |
|
Memoria insufficiente per soddisfare la richiesta. |
Commenti
La memoria allocata è spostabile. 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 |
|
| Libreria dei tipi |
|
| DLL |
|
| IID |
IID_ISCardTypeConv è definito come 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Vedi anche