Função FilterConnectCommunicationPort (fltuser.h)

Artigo
08/23/2023

FilterConnectCommunicationPort abre uma nova conexão com uma porta do servidor de comunicação criada por um minifiltro do sistema de arquivos.

Sintaxe

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

Ponteiro para uma cadeia de caracteres largos terminada em NULL que contém o nome totalmente qualificado da porta do servidor de comunicação (por exemplo, L"\MyFilterPort").

[in] dwOptions

Opções de conexão para a porta de comunicação. Antes de Windows 8.1, esse valor é definido como 0.

Valor	Significado
FLT_PORT_FLAG_SYNC_HANDLE	O identificador retornado no hPort é para E/S síncrona. Esse sinalizador está disponível a partir do Windows 8.1.

[in, optional] lpContext

Ponteiro para informações de contexto fornecidas pelo chamador a serem passadas para a rotina de notificação de conexão do minifiltro do modo kernel. (Consulte o parâmetro ConnectNotifyCallback na página de referência de FltCreateCommunicationPort.) Esse parâmetro é opcional e pode ser NULL.

[in] wSizeOfContext

Tamanho, em bytes, da estrutura para a qual o parâmetro lpContext aponta. Se o valor de lpContext não for NULL, esse parâmetro deverá ser diferente de zero. Se lpContext for NULL, esse parâmetro deverá ser zero.

[in, optional] lpSecurityAttributes

Ponteiro para uma estrutura SECURITY_ATTRIBUTES que determina se o indicador retornado pode ser herdado por processos filhos. Para obter mais informações sobre a estrutura SECURITY_ATTRIBUTES, consulte a documentação do SDK do Microsoft Windows. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, o identificador não poderá ser herdado.

[out] hPort

Ponteiro para uma variável alocada por chamador que recebe um identificador para a porta de conexão recém-criada se a chamada para FilterConnectCommunicationPort for bem-sucedida; caso contrário, ele receberá INVALID_HANDLE_VALUE.

Retornar valor

FilterConnectCommunicationPort retorna S_OK se tiver êxito. Caso contrário, retornará um valor de erro.

Comentários

FilterConnectCommunicationPort abre uma conexão com a porta do servidor de comunicação de um minifiltro em nome de um aplicativo de modo de usuário. O aplicativo usa o identificador de porta de conexão resultante para se comunicar com o minifiltro.

Depois de chamar FilterConnectCommunicationPort com êxito, o aplicativo poderá enviar mensagens para o minifiltro por meio da porta de conexão chamando FilterSendMessage. Ele também pode receber e responder a mensagens do minifiltro chamando FilterGetMessage e FilterReplyMessage, respectivamente. O identificador de porta de conexão retornado no parâmetro hPort é passado como o primeiro parâmetro para FilterSendMessage, FilterGetMessage e FilterReplyMessage.

Qualquer identificador obtido de FilterConnectCommunicationPort deverá eventualmente ser liberado chamando CloseHandle.