Funzione FilterConnectCommunicationPort (fltuser.h)

Articolo
02/29/2024

FilterConnectCommunicationPort apre una nuova connessione a una porta del server di comunicazione creata da un minifilter del file system.

Sintassi

HRESULT FilterConnectCommunicationPort(
  [in]           LPCWSTR               lpPortName,
  [in]           DWORD                 dwOptions,
  [in, optional] LPCVOID               lpContext,
  [in]           WORD                  wSizeOfContext,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out]          HANDLE                *hPort
);

Parametri

[in] lpPortName

Puntatore a una stringa di caratteri wide-carattere con terminazione NULL contenente il nome completo della porta del server di comunicazione, ad esempio L"\MyFilterPort").

[in] dwOptions

Opzioni di connessione per la porta di comunicazione. Prima di Windows 8.1, questo valore è impostato su 0.

Valore	Significato
FLT_PORT_FLAG_SYNC_HANDLE	L'handle restituito in hPort è per I/O sincrono. Questo flag è disponibile a partire da Windows 8.1.

[in, optional] lpContext

Puntatore a informazioni di contesto fornite dal chiamante da passare alla routine di notifica di connessione in modalità kernel. Vedere il parametro ConnectNotifyCallback nella pagina di riferimento per FltCreateCommunicationPort. Questo parametro è facoltativo e può essere NULL.

[in] wSizeOfContext

Dimensioni, in byte, della struttura a cui punta il parametro lpContext . Se il valore di lpContext non è NULL, questo parametro deve essere diverso da zero. Se lpContext è NULL, questo parametro deve essere zero.

[in, optional] lpSecurityAttributes

Puntatore a una struttura SECURITY_ATTRIBUTES che determina se l'handle restituito può essere ereditato dai processi figlio. Per altre informazioni sulla struttura SECURITY_ATTRIBUTES, vedere la documentazione Microsoft Windows SDK. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, l'handle non può essere ereditato.

[out] hPort

Puntatore a una variabile allocata dal chiamante che riceve un handle per la porta di connessione appena creata se la chiamata a FilterConnectCommunicationPort ha esito positivo; in caso contrario, riceve INVALID_HANDLE_VALUE.

Valore restituito

FilterConnectCommunicationPort restituisce S_OK se riuscito. In caso contrario, restituisce un valore di errore.

Commenti

FilterConnectCommunicationPort apre una connessione alla porta del server di comunicazione di un minifilter per conto di un'applicazione in modalità utente. L'applicazione usa l'handle della porta di connessione risultante per comunicare con il minifilter.

Dopo aver chiamato filterConnectCommunicationPort, l'applicazione può inviare messaggi al minifilter tramite la porta di connessione chiamando FilterSendMessage. Può anche ricevere e rispondere ai messaggi dal minifilter chiamando rispettivamente FilterGetMessage e FilterReplyMessage. L'handle della porta di connessione restituito nel parametro hPort viene passato come primo parametro a FilterSendMessage, FilterGetMessage e FilterReplyMessage.

Qualsiasi handle ottenuto da FilterConnectCommunicationPort deve essere rilasciato chiamando CloseHandle.