GetHGlobalFromStream

9/8/2008

Essa função recupera o identificador global memória para um transmitir que foi criado por um chamar para o CreateStreamOnHGlobal função.

Syntax

WINOLEAPI GetHGlobalFromStream(
  IStream* pstm,
  HGLOBAL* phglobal
);

Parameters

• pstm
  [no] IStream ponteiro para o objeto de fluxo criado por um chamar para o CreateStreamOnHGlobal função.

• phglobal
  [out] Ponteiro para o atual identificador memória usada pelo objeto especificado transmitir.

Return Value

O seguinte valores HRESULT podem ser retornados.

Valor	Descrição
S_OK	Indica que o identificador foi retornado.
E_INVALIDARG	Indica um valor inválido especificado para o pstm parâmetro. Ele também pode indicar que a objeto de fluxo passado não é um criado por um chamar para o CreateStreamOnHGlobal função.

Remarks

Essa função retorna o identificador pode diferir do original identificador devido a intermediárias LocalRealloc Chamadas.

Esta função pode ser chamado somente de dentro o mesmo processo em que a matriz byte foi criado.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
CreateStreamOnHGlobal
IStream

Concepts

Determining Supported COM APIs

Other Resources

LocalReAlloc