Función FilterConnectCommunicationPort (fltuser.h)

Artículo
11/20/2024

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
FLT_PORT_FLAG_SYNC_HANDLE	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 para FltCreateCommunicationPort). Este parámetro es opcional y se puede null.

[in] wSizeOfContext

Tamaño, en bytes, de la estructura a la que apunta el parámetro lpContext. Si el valor de lpContext no esNULL, 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 los procesos secundarios pueden heredar el identificador devuelto. Para obtener más información sobre la estructura de SECURITY_ATTRIBUTES, consulte la documentación del SDK de Microsoft Windows. Este parámetro es opcional y se puede 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.

Observaciones

FilterConnectCommunicationPort abre una conexión con el puerto del servidor de comunicación de un minifiltro en nombre de una aplicación en modo de usuario. La aplicación usa el identificador 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, FilterGetMessagey FilterReplyMessage.

Cualquier identificador obtenido de FilterConnectCommunicationPort debe liberarse llamando a CloseHandle.