Método ISCardTypeConv::ConvertSafeArrayToByteBuffer
[O método ConvertSafeArrayToByteBuffer está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. Os Módulos de Cartão Inteligente fornecem funcionalidade semelhante.]
O método ConvertSafeArrayToByteBuffer converte uma matriz de bytes definida como SAFEARRAY em um buffer universal de bytes (objeto IStream ).
O buffer de bytes criado é um fluxo mapeado em um bloco de memória. Para acessar ou gerenciar o buffer, use os métodos fornecidos pela interface IStream . Um recurso exclusivo sobre essa implementação de matriz é que, quando você chamar o método IStream::Release , a memória subjacente será liberada para você.
Sintaxe
HRESULT ConvertSafeArrayToByteBuffer(
[in] LPSAFEARRAY pbyArray,
[out] LPBYTEBUFFER *ppbyBuff
);
Parâmetros
-
pbyArray [in]
-
Ponteiro para o SAFEARRAY a ser convertido.
-
ppbyBuff [out]
-
Ponteiro para o objeto IStream a ser retornado.
Valor retornado
O método retorna um dos seguintes valores possíveis:
| Código de retorno | Descrição |
|---|---|
|
Memória alocada com êxito. |
|
Há algo errado com um ou mais dos parâmetros passados para a função. |
|
Um parâmetro do tipo de ponteiro estava incorreto. |
|
Não há memória livre suficiente para atender à solicitação. |
Comentários
A memória alocada é movevel. Use o método IStream::Release para liberar a memória.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Fim do suporte ao cliente |
Windows XP |
| Fim do suporte ao servidor |
Windows Server 2003 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_ISCardTypeConv é definido como 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Confira também