Netbios, fonction (nb30.h)

  • Article

[Netbios n’est pas pris en charge sur Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation]

La fonction Netbios interprète et exécute le bloc de contrôle réseau (NCB) spécifié.

La fonction Netbios est fournie principalement pour les applications qui ont été écrites pour l’interface NetBIOS et qui doivent être transférées vers Windows. Les applications qui ne nécessitent pas de compatibilité avec NetBIOS doivent utiliser d’autres interfaces, telles que les sockets Windows, les mailslots, les canaux nommés, RPC ou COM distribué pour effectuer des tâches similaires à celles prises en charge par NetBIOS. Ces autres interfaces sont plus flexibles et portables.

Syntaxe

UCHAR Netbios(
  PNCB pncb
);

Paramètres

pncb

Pointeur vers une structure NCB qui décrit le bloc de contrôle réseau.

Valeur retournée

Pour les demandes synchrones, la valeur de retour est le code de retour dans la structure NCB . Cette valeur est également retournée dans le ncb_retcode membre de la structure NCB .

Pour les requêtes asynchrones, il existe les possibilités suivantes :

  • Si la commande asynchrone s’est déjà terminée lorsque Netbios retourne à son appelant, la valeur de retour est le code de retour de la structure NCB, comme s’il s’agissait d’une structure NCB synchrone.
  • Si la commande asynchrone est toujours en attente lorsque Netbios retourne à son appelant, la valeur de retour est zéro.
Si l’adresse spécifiée par le paramètre pncb n’est pas valide, la valeur de retour est NRC_BADNCB.

Si la longueur de la mémoire tampon spécifiée dans le membre ncb_length de la structure NCB est incorrecte, ou si la mémoire tampon spécifiée par le membre ncb_retcode est protégée contre les opérations d’écriture, la valeur de retour est NRC_BUFLEN.

Remarques

Lorsqu’un bloc de contrôle réseau asynchrone se termine et que le membre ncb_post est différent de zéro, la routine spécifiée dans ncb_post est appelée avec un seul paramètre. Ce paramètre contient un pointeur vers une structure NCB , le bloc de contrôle réseau.

La structure NCB contient un handle d’un événement (le membre ncb_event ). Le système définit l’événement à l’état non signé lorsqu’une commande NetBIOS asynchrone est acceptée, et définit l’événement à l’état signalé lorsque la commande NetBIOS asynchrone est terminée. Seuls les événements de réinitialisation manuelle doivent être utilisés pour la synchronisation. Un événement spécifié ne doit pas être associé à plusieurs commandes NetBIOS asynchrones actives.

L’utilisation de ncb_event pour envoyer des demandes asynchrones nécessite moins de ressources système que l’utilisation de ncb_post. En outre, lorsque ncb_event est différent de zéro, la requête en attente est annulée si le thread se termine avant le traitement de la demande. Cela n’est pas vrai pour les demandes envoyées à l’aide de ncb_post.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête nb30.h
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

BCN