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 |