Compartilhar via


Método ISCardTypeConv::GetAtIStreamMemory

[O método GetAtIStreamMemory 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 GetAtIStreamMemory adquire um ponteiro de bytes para o bloco de memória HGLOBAL gerenciado pela interface COM do IStream .

Essa é uma maneira de acessar a memória no IStream sem precisar obter o valor sizeof para o bloco de memória em bytes e ler os bytes em uma matriz de bytes temporária usando a interface IStream .

Sintaxe

HRESULT GetAtIStreamMemory(
  [in]  LPSTREAM    pStrm,
  [out] LPBYTEARRAY *ppMem
);

Parâmetros

pStrm [in]

Um ponteiro para a interface COM do IStream que gerencia o bloco de memória HGLOBAL.

ppMem [out]

Um ponteiro para o primeiro byte do bloco de memória HGLOBAL se tiver êxito; else, NULL se a operação falhar.

Valor retornado

O método retorna um dos valores possíveis a seguir.

Código de retorno Descrição
S_OK
Memória alocada com êxito.
E_INVALIDARG
Há algo errado com um ou mais dos parâmetros passados para a função.
E_POINTER
Um parâmetro do tipo de ponteiro estava incorreto.
E_OUTOFMEMORY
Não há memória livre suficiente para atender à solicitação.

 

Comentários

A contagem de referência de IStream será incrementada para cada ponteiro ppMem adquirido.

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
Scarddat.h
Biblioteca de tipos
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardTypeConv é definido como 53B6AA63-3F56-11D0-916B-00AA00C18068

Confira também

ISCardTypeConv

Valores retornados do cartão inteligente