Método IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle (windowsstoragecom.h)
Obtém um identificador de um fluxo de bytes de acesso aleatório que o método StorageFile.OpenAsync criou e registra um método de retorno de chamada que você deseja executar quando o bloqueio oportunista para o identificador é interrompido.
Sintaxe
HRESULT OpenUnbufferedFileHandle(
[in] IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
[out, retval] DWORD_PTR *fileHandle
);
Parâmetros
[in] oplockBreakCallback
Uma interface que contém a implementação do método IUnbufferedFileHandleOplockCallback::OnBrokenCallback que você deseja executar quando o bloqueio oportunista para o identificador é interrompido.
[out, retval] fileHandle
O identificador do fluxo de bytes de acesso aleatório.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle abre um novo identificador aberto para GENERIC_READ. IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle não retorna o identificador real subjacente ao fluxo ou uma duplicata desse identificador.
Chame IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle quando você não precisar mais do identificador. O identificador também é fechado quando o bloqueio oportunista quebra, portanto, seu código deve processar exceções que ocorrem quando o identificador não é válido.
Requisitos
| Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | windowsstoragecom.h |
| DLL | Windows.storage.dll |
Confira também
IUnbufferedFileHandleOplockCallback