Compartilhar via


Função ReleaseStgMedium (ole2.h)

Libera o meio de armazenamento especificado.

Sintaxe

void ReleaseStgMedium(
       LPSTGMEDIUM unnamedParam1
);

Parâmetros

unnamedParam1

Valor retornado

Nenhum

Comentários

A função ReleaseStgMedium chama o método ou função apropriado para liberar o meio de armazenamento especificado. Use essa função durante operações de transferência de dados em que as estruturas médias de armazenamento são parâmetros, como IDataObject::GetData ou IDataObject::SetData. Além de identificar o tipo do meio de armazenamento, essa estrutura especifica o método Release apropriado para liberar o meio de armazenamento quando ele não for mais necessário.

É comum passar um STGMEDIUM de um corpo de código para outro, como em IDataObject::GetData, no qual o chamado pode alocar um meio e devolvê-lo ao chamador. ReleaseStgMedium permite flexibilidade se o corpo receptor do código possui o meio ou se o provedor original do meio ainda o possui, nesse caso, o código receptor precisa informar ao provedor que ele pode liberar o meio.

Quando o provedor original do meio é responsável por liberar o meio, o provedor chama ReleaseStgMedium, especificando o meio e o ponteiro IUnknown apropriado como o membro da estrutura punkForRelease . Dependendo do tipo de meio de armazenamento que está sendo liberado, uma das seguintes ações é executada, seguida por uma chamada para o método IUnknown::Release no ponteiro IUnknown especificado.

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

O provedor indica que o receptor do meio é responsável por liberar o meio especificando NULL para o membro da estrutura punkForRelease . Em seguida, o receptor chama ReleaseStgMedium, que faz uma chamada conforme descrito na tabela a seguir, dependendo do tipo de meio de armazenamento que está sendo liberado.

Médio Ação ReleaseStgMedium
TYMED_HGLOBAL Chama a função GlobalFree no identificador .
TYMED_GDI Chama a função DeleteObject no identificador.
TYMED_ENHMF Exclui o metarquivo aprimorado.
TYMED_MFPICT O hMF que ele contém é excluído com a função DeleteMetaFile ; em seguida, o próprio identificador é passado para GlobalFree.
TYMED_FILE Libera o arquivo de disco excluindo-o. Libera a cadeia de caracteres de nome de arquivo usando os mecanismos de gerenciamento de memória padrão.
TYMED_ISTREAM Chama IStream::Release.
TYMED_ISTORAGE Chama IStorage::Release.
 

Em ambos os casos, após a chamada para ReleaseStgMedium, o meio de armazenamento especificado é inválido e não pode mais ser usado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-3 (introduzido no Windows 10, versão 10.0.10240)

Confira também

STGMEDIUM