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 do Windows 8.1, esse valor é definido como 0.

[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 no modo kernel. (Consulte o parâmetro ConnectNotifyCallback na página de referência para FltCreateCommunicationPort.) Esse parâmetro é opcional e pode ser NULL.

[in] wSizeOfContext

Tamanho, em bytes, da estrutura à qual o parâmetro lpContext aponta. Se o valor de lpContext não forNULL, 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 de SECURITY_ATTRIBUTES que determina se o identificador retornado pode ser herdado por processos filho. 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.

Valor de retorno

FilterConnectCommunicationPort retornará S_OK se bem-sucedido. Caso contrário, ele retornará um valor de erro.

Observações

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 com êxito FilterConnectCommunicationPort, o aplicativo poderá enviar mensagens para o minifiltro por meio da porta de conexão chamando FilterSendMessage. Ele também pode receber e responder às 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, FilterGetMessagee FilterReplyMessage.

Qualquer identificador obtido de FilterConnectCommunicationPort deve eventualmente ser liberado chamando CloseHandle.

Requisitos

Consulte também

CloseHandle

FilterGetMessage

FilterReplyMessage

FilterSendMessage

FltBuildDefaultSecurityDescriptor

FltCloseClientPort

FltCloseCommunicationPort

FltCreateCommunicationPort

FltFreeSecurityDescriptor

SECURITY_ATTRIBUTES