Função FilterConnectCommunicationPort (fltuser.h)
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 |
---|---|
|
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | fltuser.h (inclua Fltuser.h) |
Biblioteca | FltLib.lib |
DLL | FltLib.dll |