FilterConnectCommunicationPort, fonction (fltuser.h)

Article
02/26/2024

FilterConnectCommunicationPort ouvre une nouvelle connexion à un port de serveur de communication créé par un minifiltre de 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 minifiltre 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 pas NULL, ce paramètre doit être différent de zéro. Si lpContext a la valeur 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 des processus enfants. Pour plus d’informations sur la structure SECURITY_ATTRIBUTES, consultez la documentation Microsoft Windows SDK. Ce paramètre est facultatif et peut être NULL. Si ce paramètre a la valeur 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, elle reçoit INVALID_HANDLE_VALUE.

Valeur retournée

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 minifiltre pour le compte d’une application en mode utilisateur. L’application utilise le handle de port de connexion résultant pour communiquer avec le minifiltre.

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

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