Método ISCardTypeConv::CreateByteBuffer
[O método CreateByteBuffer 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 CreateByteBuffer cria um buffer universal de bytes mapeados em um objeto IStream (IByteBuffer).
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á lançada para você.
Sintaxe
HRESULT CreateByteBuffer(
[in] DWORD dwAllocSize,
[out] LPBYTEBUFFER *ppbyBuff
);
Parâmetros
-
dwAllocSize [in]
-
Tamanho em bytes da memória a ser alocada para a matriz.
-
ppbyBuff [out]
-
Ponteiro para o objeto IStream a ser retornado.
Valor retornado
Os possíveis valores retornados são os seguintes:
| 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. |
|
Não há memória livre suficiente para atender à solicitação. |
Comentários
A memória alocada é móvel. Use o método IStream::Release para liberar a memória.
Para criar uma matriz de bytes C/C++ típica, chame CreateByteArray.
Para criar um SAFEARRAY de Automação de caracteres não assinados (bytes), chame CreateSafeArray.
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