IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE IOCTL (mountmgr.h)
Cette IOCTL dirige le gestionnaire de montage pour conserver un lien symbolique actif une fois que le gestionnaire Plug-and-Play a donné une notification indiquant que son volume correspondant est passé hors connexion. Lorsque le volume revient en ligne, le gestionnaire de montage réaffecte le lien symbolique au volume. Aucun autre volume n’est autorisé à revendiquer le lien symbolique alors que son propriétaire d’origine est hors connexion.
Les clusters utilisent cette IOCTL pour s’assurer qu’un nœud peut continuer à accéder à un volume avec la même lettre de lecteur, même si le volume n’est pas continuellement présent dans le système.
Code principal
Mémoire tampon d’entrée
Le client du gestionnaire de montage charge la structure suivante avec le lien symbolique qui persistera même après la suppression de son volume du système. La structure initialisée MOUNTMGR_TARGET_NAME est insérée au début de la mémoire tampon à Irp->AssociatedIrp.SystemBuffer.
Longueur de la mémoire tampon d’entrée
Parameters.DeviceIoControl.InputBufferLength à l’emplacement de la pile d’E/S de l’IRP indique la taille, en octets, de la mémoire tampon d’entrée, qui doit être supérieure ou égale à sizeof(MOUNTMGR_TARGET_NAME).
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Mémoire tampon d’entrée/sortie
N/A
Longueur de la mémoire tampon d’entrée/sortie
N/A
Bloc d’état
Si l’opération réussit, le champ Status est défini sur STATUS_SUCCESS.
La taille de la mémoire tampon d’entrée, indiquée par InputBufferLength, doit être suffisamment grande pour contenir la structure MOUNTMGR_TARGET_NAME et le nom du lien symbolique qui le suit. S’il n’est pas suffisamment grand, le champ Status est défini sur STATUS_INVALID_PARAMETER.
Remarques
Pour plus d’informations, consultez prise en charge des demandes mount Manager dans un pilote de classe de stockage.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | mountmgr.h (include Mountmgr.h) |