Compartilhar via


Função StgGetIFillLockBytesOnFile (objbase.h)

[A função StgGetIFillLockBytesOnFile está obsoleta. As informações a seguir são fornecidas para dar suporte a versões do Windows anteriores ao Windows 2000.]

A função StgGetIFillLockBytesOnFile abre um objeto wrapper em um arquivo temporário.

Sintaxe

HRESULT StgGetIFillLockBytesOnFile(
  [in]  OLECHAR const  *pwcsName,
  [out] IFillLockBytes **ppflb
);

Parâmetros

[in] pwcsName

Um ponteiro para o nome da cadeia de caracteres unicode terminada em nulo do arquivo para o qual um objeto wrapper é criado.

[out] ppflb

Um ponteiro para a variável de ponteiro IFillLockBytes* que recebe o ponteiro de interface para o novo objeto wrapper de matriz de bytes.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, além dos seguintes:

A função StgGetIFillLockBytesOnFile também pode retornar erros do sistema de arquivos.

Comentários

O moniker que gerencia o download do arquivo especificado em pwcsName chama essa função no curso da criação do armazenamento assíncrono necessário para gerenciar o download assíncrono de dados. O moniker primeiro cria um arquivo temporário e, em seguida, chama essa função para criar o objeto wrapper nesse arquivo. Por fim, o moniker chama StgOpenAsyncDocfileOnIFillLockBytes para abrir o armazenamento raiz do arquivo composto a ser baixado no arquivo temporário.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho objbase.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Ifilllockbytes

ILockBytes

StgOpenAsyncDocfileOnIFillLockBytes