FilterConnectCommunicationPort, fonction (fltuser.h)

Article
11/20/2024

FilterConnectCommunicationPort ouvre une nouvelle connexion à un port de serveur de communication créé par un minifilter du système de fichiers.

Syntaxe

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

Paramètres

[in] lpPortName

Pointeur vers une chaîne de caractères larges terminée par NULL contenant le nom complet du port du serveur de communication (par exemple, L"\MyFilterPort »).

[in] dwOptions

Options de connexion pour le port de communication. Avant Windows 8.1, cette valeur est définie sur 0.

Valeur	Signification
FLT_PORT_FLAG_SYNC_HANDLE	Le handle retourné dans hPort est destiné aux E/S synchrones. Cet indicateur est disponible à partir de Windows 8.1.

[in, optional] lpContext

Pointeur vers les informations de contexte fournies par l’appelant à passer à la routine de notification de connexion du minifilter en mode noyau. (Consultez le paramètre ConnectNotifyCallback dans la page de référence pour FltCreateCommunicationPort.) Ce paramètre est facultatif et peut être NULL.

[in] wSizeOfContext

Taille, en octets, de la structure vers laquelle pointe le paramètre lpContext. Si la valeur de lpContext n’est pasnull, ce paramètre doit être différent de zéro. Si lpContext est NULL, ce paramètre doit être égal à zéro.

[in, optional] lpSecurityAttributes

Pointeur vers une structure SECURITY_ATTRIBUTES qui détermine si le handle retourné peut être hérité par les processus enfants. Pour plus d’informations sur la structure SECURITY_ATTRIBUTES, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est NULL, le handle ne peut pas être hérité.

[out] hPort

Pointeur vers une variable allouée par l’appelant qui reçoit un handle pour le port de connexion nouvellement créé si l’appel à FilterConnectCommunicationPort réussit ; sinon, il reçoit INVALID_HANDLE_VALUE.

Valeur de retour

FilterConnectCommunicationPort retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur.

Remarques

FilterConnectCommunicationPort ouvre une connexion au port du serveur de communication d’un minifilter pour le compte d’une application en mode utilisateur. L’application utilise le handle de port de connexion résultant pour communiquer avec le minifilter.

Une fois qu’elle a correctement appelé FilterConnectCommunicationPort, l’application peut envoyer des messages au minifilter via le port de connexion en appelant FilterSendMessage. Il peut également recevoir et répondre aux messages du minifilter en appelant FilterGetMessage et FilterReplyMessage, respectivement. Le handle de port de connexion retourné dans le paramètre hPort est passé en tant que premier paramètre à FilterSendMessage, FilterGetMessageet FilterReplyMessage.

Tout handle obtenu à partir de FilterConnectCommunicationPort doit finalement être libéré en appelant CloseHandle.