Structure NCB (nb30.h)

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

La structure NCB représente un bloc de contrôle réseau. Il contient des informations sur la commande à exécuter, une routine de publication facultative, un handle d’événement facultatif et un pointeur vers une mémoire tampon utilisée pour les messages ou d’autres données. Un pointeur vers cette structure est passé à la fonction Netbios .

Syntaxe

typedef struct _NCB {
  UCHAR  ncb_command;
  UCHAR  ncb_retcode;
  UCHAR  ncb_lsn;
  UCHAR  ncb_num;
  PUCHAR ncb_buffer;
  WORD   ncb_length;
  UCHAR  ncb_callname[NCBNAMSZ];
  UCHAR  ncb_name[NCBNAMSZ];
  UCHAR  ncb_rto;
  UCHAR  ncb_sto;
  void()(_NCB *)  * ncb_post;
  UCHAR  ncb_lana_num;
  UCHAR  ncb_cmd_cplt;
#if ...
  UCHAR  ncb_reserve[18];
#else
  UCHAR  ncb_reserve[10];
#endif
  HANDLE ncb_event;
} NCB, *PNCB;

Membres

ncb_command

Spécifie le code de commande et un indicateur qui indique si la structure NCB est traitée de manière asynchrone. Le bit le plus significatif contient l’indicateur. Si la constante ASYNCH est combinée à un code de commande (à l’aide de l’opérateur OR), la structure NCB est traitée de manière asynchrone. Les codes de commande suivants sont pris en charge.

ncb_retcode

Spécifie le code de retour. Cette valeur est définie sur NRC_PENDING pendant qu’une opération asynchrone est en cours. Le système retourne l’une des valeurs suivantes :

ncb_lsn

Identifie le numéro de session local. Ce nombre identifie de manière unique une session au sein d’un environnement. Ce nombre est retourné par la fonction Netbios après une commande NCBCALL réussie.

ncb_num

Spécifie le numéro du nom du réseau local. Ce nombre est retourné par Netbios après une commande NCBADDNAME ou NCBADDGRNAME réussie. Ce nombre, et non le nom, doit être utilisé avec toutes les commandes de datagramme et pour les commandes NCBRECVANY .

Le nombre de NAME_NUMBER_1 est toujours 0x01. La fonction Netbios affecte des valeurs dans la plage 0x02 à 0xFE pour les noms restants.

ncb_buffer

Pointeur vers la mémoire tampon de messages. La mémoire tampon doit avoir un accès en écriture. Ses utilisations sont les suivantes :

ncb_length

Spécifie la taille, en octets, de la mémoire tampon de message. Pour les commandes de réception, ce membre est défini par la fonction Netbios pour indiquer le nombre d’octets reçus.

Si la longueur de la mémoire tampon est incorrecte, la fonction Netbios retourne le code d’erreur NRC_BUFLEN .

ncb_callname[NCBNAMSZ]

Spécifie le nom de l’application distante. Des caractères d’espace de fin doivent être fournis pour que la longueur de la chaîne soit égale à NCBNAMSZ.

ncb_name[NCBNAMSZ]

Spécifie le nom sous lequel l’application est connue. Des caractères d’espace de fin doivent être fournis pour que la longueur de la chaîne soit égale à NCBNAMSZ.

ncb_rto

Spécifie le délai d’attente pour les opérations de réception, en unités de 500 millisecondes, pour la session. Une valeur de zéro n’implique aucun délai d’attente. Spécifiez avec la commande NCBCALL ou NCBLISTEN . Affecte les commandes NCBRECV suivantes.

ncb_sto

Spécifie le délai d’attente pour les opérations d’envoi, en unités de 500 millisecondes, pour la session. Une valeur de zéro n’implique aucun délai d’attente. Spécifiez avec la commande NCBCALL ou NCBLISTEN . Affecte les commandes NCBSEND et NCBCHAINSEND suivantes.

ncb_post

Spécifie l’adresse de la post-routine à appeler lorsque la commande asynchrone est terminée. La post-routine est définie comme suit :

NCB_POST PostRoutine( PNCB pncb ) ;

où le paramètre pncb est un pointeur vers la structure NCB terminée.

ncb_lana_num

Spécifie le numéro d’adaptateur LAN. Ce nombre de base zéro correspond à un fournisseur de transport particulier à l’aide d’une carte d’adaptateur LAN particulière.

ncb_cmd_cplt

Spécifie l’indicateur d’exécution de la commande. Cette valeur est identique au membre ncb_retcode .

ncb_reserve[18]

Réservés au; doit être égal à zéro.

La longueur X du tableau ncb_reserve dépend de l’architecture système. Pour les systèmes 64 bits, le tableau contient 18 éléments. Sinon, le tableau contient 10 éléments.

ncb_reserve[10]

Réservés au; doit être égal à zéro.

La longueur X du tableau ncb_reserve dépend de l’architecture système. Pour les systèmes 64 bits, le tableau contient 18 éléments. Sinon, le tableau contient 10 éléments.

ncb_event

Spécifie un handle pour un objet d’événement qui est défini sur l’état non signé lorsqu’une commande asynchrone est acceptée, et qui est défini sur l’état signalé lorsque la commande asynchrone est terminée. L’événement est signalé si la fonction Netbios retourne une valeur différente de zéro. 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 asynchrones actives.

Le membre ncb_event doit être égal à zéro si le membre ncb_command n’a pas l’indicateur ASYNCH défini ou si ncb_post est différent de zéro. Dans le cas contraire, Netbios retourne le code d’erreur NRC_ILLCMD .

Remarques

L’utilisation de ncb_event pour émettre des requêtes 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 requêtes asynchrones envoyées à l’aide de ncb_post.

Configuration requise

Voir aussi

ACTION_HEADER

ADAPTER_STATUS

FIND_NAME_BUFFER

FIND_NAME_HEADER

LANA_ENUM

NAME_BUFFER

NetBIOS Structures

Netbios

SESSION_BUFFER

SESSION_HEADER

Vue d’ensemble de l’interface NetBIOS