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 |
---|---|
|
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 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 |
|
Biblioteca de tipos |
|
DLL |
|
IID |
IID_ISCardTypeConv é definido como 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Confira também