ReleaseStgMedium

9/8/2008

Essa função libera o meio de armazenamento especificado.

Syntax

void ReleaseStgMedium( 
  STGMEDIUM* pmedium
);

Parameters

• pmedium
  [no] Ponteiro para o meio de armazenamento que deve ser liberado.

Return Value

Nenhum.

Remarks

O ReleaseStgMedium função chama o apropriado método ou função para versão o meio de armazenamento especificado.

Use esta função durante operações transferência de dados onde estruturas meio de armazenamento são parâmetros.

Bem como identificar o tipo de meio de armazenamento, essa estrutura especifica o apropriado Lançamento método para liberar o meio de armazenamento quando ele é necessário no longer.

É comum para transmitir um STGMEDIUM De um corpo de codificar para outro, no qual o chamado um pode alocar uma mídia e retorná-lo para o chamador.

ReleaseStgMedium permite flexibilidade na se o corpo de recebimento de codificar proprietária de médio porte, ou se o original provedor de médio porte ainda possui-lo; no qual maiúsculas e minúsculas a codificar de recebimento deve informar o provedor que ele pode livre de médio porte.

Quando o original provedor de médio porte é responsável para liberar a mídia, as chamadas provedor ReleaseStgMedium, especificando a mídia e o apropriado IUnknown ponteiro como o punkForRelease membro estrutura.

Dependendo o tipo de meio de armazenamento que está sendo liberada, uma do seguinte ações é tirado, seguido por um chamar para o Lançamento método em especificado IUnknown ponteiro.

Médio	Ação ReleaseStgMedium
TYMED_HGLOBAL	Nenhum.
TYMED_GDI	Nenhum.
TYMED_ENHMF	Nenhum.
TYMED_MFPICT	Nenhum.
TYMED_FILE	Libera o seqüência de caracteres nome arquivo usando padrão mecanismos gerenciamento memória.
TYMED_ISTREAM	Chamadas IStream::Release.
TYMED_ISTORAGE	Chamadas IStorage::Release.

O provedor indica que o receptor de médio porte é responsável por liberar a mídia especificando NULL para a punkForRelease membro estrutura.

Em seguida, chama o receptor ReleaseStgMedium, que torna um chamar conforme descrito na seguinte tabela, depending on o tipo de meio de armazenamento que está sendo liberada.

Médio	Ação ReleaseStgMedium
TYMED_HGLOBAL	Chamadas de LocalFree função sobre o identificador.
TYMED_GDI	Chama a Microsoft® Win32® ExcluirObjeto função sobre o identificador.
TYMED_ENHMF	Exclui a metarquivo avançado.
TYMED_FILE	Libera o arquivo em disco, excluindo-lo. Libera o seqüência de caracteres nome arquivo usando o padrão paradigma gerenciamento memória.
TYMED_ISTREAM	Chamadas IStream::Release.
TYMED_ISTORAGE	Chamadas IStorage::Release.

Em ambos os maiúsculas e minúsculas, após a chamar para ReleaseStgMedium, o meio de armazenamento especificado não é inválido e pode mais ser usado.

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.10 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
STGMEDIUM
IUnknown::Release
IUnknown

Concepts

Determining Supported COM APIs

Other Resources

LocalFree