Función FilterConnectCommunicationPort (fltuser.h)
FilterConnectCommunicationPort abre una nueva conexión a un puerto de servidor de comunicación creado por un minifiltro del sistema de archivos.
Sintaxis
HRESULT FilterConnectCommunicationPort(
[in] LPCWSTR lpPortName,
[in] DWORD dwOptions,
[in, optional] LPCVOID lpContext,
[in] WORD wSizeOfContext,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[out] HANDLE *hPort
);
Parámetros
[in] lpPortName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre completo del puerto del servidor de comunicación (por ejemplo, L"\MyFilterPort").
[in] dwOptions
Opciones de conexión para el puerto de comunicación. Antes de Windows 8.1, este valor se establece en 0.
Valor | Significado |
---|---|
|
El identificador devuelto en hPort es para E/S sincrónica. Esta marca está disponible a partir de Windows 8.1. |
[in, optional] lpContext
Puntero a la información de contexto proporcionada por el autor de la llamada que se va a pasar a la rutina de notificación de conexión del minifiltro en modo kernel. (Consulte el parámetro ConnectNotifyCallback en la página de referencia de FltCreateCommunicationPort). Este parámetro es opcional y puede ser NULL.
[in] wSizeOfContext
Tamaño, en bytes, de la estructura a la que apunta el parámetro lpContext . Si el valor de lpContext no es NULL, este parámetro debe ser distinto de cero. Si lpContext es NULL, este parámetro debe ser cero.
[in, optional] lpSecurityAttributes
Puntero a una estructura de SECURITY_ATTRIBUTES que determina si el identificador devuelto se puede heredar de procesos secundarios. Para obtener más información sobre la estructura de SECURITY_ATTRIBUTES, consulte la documentación de Microsoft Windows SDK. Este parámetro es opcional y puede ser NULL. Si este parámetro es NULL, no se puede heredar el identificador.
[out] hPort
Puntero a una variable asignada por el autor de la llamada que recibe un identificador para el puerto de conexión recién creado si la llamada a FilterConnectCommunicationPort se realiza correctamente; de lo contrario, recibe INVALID_HANDLE_VALUE.
Valor devuelto
FilterConnectCommunicationPort devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.
Comentarios
FilterConnectCommunicationPort abre una conexión al puerto del servidor de comunicación de un minifiltro en nombre de una aplicación en modo de usuario. La aplicación usa el controlador de puerto de conexión resultante para comunicarse con el minifiltro.
Después de llamar correctamente a FilterConnectCommunicationPort, la aplicación puede enviar mensajes al minifiltro a través del puerto de conexión llamando a FilterSendMessage. También puede recibir y responder a los mensajes del minifiltro llamando a FilterGetMessage y FilterReplyMessage, respectivamente. El identificador de puerto de conexión devuelto en el parámetro hPort se pasa como primer parámetro a FilterSendMessage, FilterGetMessage y FilterReplyMessage.
Cualquier identificador que se obtenga de FilterConnectCommunicationPort debe liberarse al llamar a CloseHandle.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Encabezado | fltuser.h (incluya Fltuser.h) |
Library | FltLib.lib |
Archivo DLL | FltLib.dll |