Handles implicites et explicites

Pour déclarer un handle de sérialisation, utilisez le type de handle primitif handle_t. Les handles de sérialisation peuvent être explicites ou implicites. Spécifiez des handles implicites dans l’ACF de votre application à l’aide de l’attribut [implicit_handle]. Le compilateur MIDL génère une variable de handle de sérialisation globale. Les procédures de sérialisation avec un handle implicite utilisent cette variable globale pour accéder à un contexte de sérialisation valide.

Lorsque vous utilisez l’encodage de type, les routines générées prenant en charge la sérialisation d’un type particulier utilisent le handle implicite global pour accéder au contexte de sérialisation. Notez que les routines distantes peuvent avoir besoin d’utiliser le handle implicite comme handle de liaison. Assurez-vous que le handle implicite est défini sur un handle de sérialisation valide avant d’effectuer un appel de sérialisation.

Un handle explicite est spécifié comme paramètre du prototype de procédure de sérialisation dans le fichier IDL, ou il peut également être spécifié à l’aide de l’attribut [explicit_handle] dans l’ACF. Le paramètre de handle explicite est utilisé pour établir le contexte de sérialisation approprié pour la procédure. Pour établir le contexte correct dans le cas de la sérialisation de type, le compilateur génère les routines de prise en charge qui utilisent un paramètre de handle_t explicite comme handle de sérialisation. Vous devez fournir un handle de sérialisation valide lors de l’appel d’une procédure de sérialisation ou d’une routine de prise en charge du type de sérialisation.