Função StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Artigo
02/29/2024

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

StgOpenAsyncDocfileOnIFillLockBytes abre um objeto de armazenamento assíncrono raiz existente em um objeto wrapper de matriz de bytes fornecido pelo chamador.

Sintaxe

HRESULT StgOpenAsyncDocfileOnIFillLockBytes(
  [in]  IFillLockBytes *pflb,
  [in]  DWORD          grfMode,
  [in]  DWORD          asyncFlags,
  [out] IStorage       **ppstgOpen
);

Parâmetros

[in] pflb

Um ponteiro IFillLockBytes para o objeto wrapper de matriz de bytes que contém o objeto de armazenamento a ser aberto.

[in] grfMode

Um valor que especifica o modo de acesso a ser usado para abrir o objeto de armazenamento. O modo de acesso mais comum, obtido de constantes STGM, é STGM_READ.

[in] asyncFlags

Um valor que indica se um ponto de conexão em um armazenamento é herdado por seus substorages e fluxos. ASYNC_MODE_COMPATIBILITY indica que o ponto de conexão é herdado; ASYNC_MODE_DEFAULT indica que o ponto de conexão não é herdado.

[out] ppstgOpen

Um ponteiro para a variável de ponteiro IStorage* que recebe o ponteiro de interface para o objeto de armazenamento assíncrono raiz.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, bem como o seguinte:

Comentários

O armazenamento raiz do objeto de armazenamento assíncrono é aberto de acordo com o modo de acesso no parâmetro grfMode . Um ponteiro para a interface IStorage no objeto de armazenamento aberto é fornecido por meio do parâmetro ppstgOpen .

O objeto wrapper de matriz de bytes deve ter sido instanciado anteriormente por meio de uma chamada para a função StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes não dá suporte a exclusões ou modo de acesso prioritário. Caso contrário, ele funciona da mesma forma que a função StgOpenStorageOnILockBytes .

O objeto de armazenamento retornado tem um ponto de conexão para IProgressNotify.