Método IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle (windowsstoragecom.h)
Obtiene un identificador de una secuencia de bytes de acceso aleatorio que el método StorageFile.OpenAsync creó y registra un método de devolución de llamada que desea ejecutar cuando se interrumpe el bloqueo oportunista para el identificador.
Sintaxis
HRESULT OpenUnbufferedFileHandle(
[in] IUnbufferedFileHandleOplockCallback *oplockBreakCallback,
[out, retval] DWORD_PTR *fileHandle
);
Parámetros
[in] oplockBreakCallback
Interfaz que contiene la implementación del método IUnbufferedFileHandleOplockCallback::OnBrokenCallback que desea ejecutar cuando se interrumpe el bloqueo oportunista para el identificador.
[out, retval] fileHandle
Identificador de la secuencia de bytes de acceso aleatorio.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle abre un nuevo identificador abierto para GENERIC_READ. IUnbufferedFileHandleProvider::OpenUnbufferedFileHandle no devuelve el identificador real subyacente a la secuencia o un duplicado de ese identificador.
Llame a IUnbufferedFileHandleProvider::CloseUnbufferedFileHandle cuando ya no necesite el identificador. El identificador también se cierra cuando se interrumpe el bloqueo oportunista, por lo que el código debe procesar las excepciones que se producen cuando el identificador no es válido.
Requisitos
| Cliente mínimo compatible | Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | windowsstoragecom.h |
| Archivo DLL | Windows.storage.dll |
Consulte también
IUnbufferedFileHandleOplockCallback