PORT_DATA_1 structure (tcpxcv.h)

Article
08/07/2023

La fonction XcvData utilise une structure PORT_DATA_1 lorsqu’elle ajoute un port ou configure un port existant.

Syntaxe

typedef struct _PORT_DATA_1 {
  WCHAR sztPortName[MAX_PORTNAME_LEN];
  DWORD dwVersion;
  DWORD dwProtocol;
  DWORD cbSize;
  DWORD dwReserved;
  WCHAR sztHostAddress[MAX_NETWORKNAME_LEN];
  WCHAR sztSNMPCommunity[MAX_SNMP_COMMUNITY_STR_LEN];
  DWORD dwDoubleSpool;
  WCHAR sztQueue[MAX_QUEUENAME_LEN];
  WCHAR sztIPAddress[MAX_IPADDR_STR_LEN];
  BYTE  Reserved[540];
  DWORD dwPortNumber;
  DWORD dwSNMPEnabled;
  DWORD dwSNMPDevIndex;
} PORT_DATA_1, *PPORT_DATA_1;

Membres

sztPortName[MAX_PORTNAME_LEN]

Spécifie le nom du port. La constante MAX_PORTNAME_LEN est définie dans tcpxcv.h.

dwVersion

Spécifie le numéro de version de la structure PORT_DATA_1, qui est actuellement 1.

dwProtocol

Spécifie le protocole à utiliser pour le port. Cette valeur peut être PROTOCOL_RAWTCP_TYPE ou PROTOCOL_LPR_TYPE constantes définies dans tcpxcv.h.

cbSize

Spécifie la taille, en octets, de cette structure. Utilisez sizeof(PORT_DATA_1) pour cette valeur.

dwReserved

Réservé, doit être défini sur zéro.

sztHostAddress[MAX_NETWORKNAME_LEN]

Spécifie l’adresse IP ou le nom d’hôte de l’imprimante. La constante MAX_NETWORKNAME_LEN est définie dans tcpxcv.h.

sztSNMPCommunity[MAX_SNMP_COMMUNITY_STR_LEN]

Spécifie le nom de la communauté SNMP de l’imprimante. La constante MAX_SNMP_COMMUNITY_STR_LEN est définie dans tcpxcv.h.

dwDoubleSpool

Si la valeur est TRUE, indique que le double spoulage est activé. Si la valeur est FALSE, le double spoulage est désactivé.

sztQueue[MAX_QUEUENAME_LEN]

Spécifie le nom de la file d’attente LPR. La constante MAX_QUEUENAME_LEN est définie dans tcpxcv.h.

sztIPAddress[MAX_IPADDR_STR_LEN]

Spécifie l’adresse IP de l’imprimante. La constante MAX_IPADDR_STR_LEN est définie dans tcpxcv.h.

Reserved[540]

Réservé, doit être défini sur zéro.

dwPortNumber

Spécifie le numéro de port de l’appareil.

dwSNMPEnabled

Si la valeur est TRUE, indique que l’appareil prend en charge le protocole SNMP (Simple Network Management Protocol).

dwSNMPDevIndex

Spécifie l’index d’appareil SNMP.

Remarques

Lorsque la fonction XcvData est appelée pour ajouter un port ou configurer un port existant, son paramètre pOutputData doit être défini avec l’adresse d’une structure de PORT_DATA_1, qui sera renseignée lorsque la fonction sera retournée. Pour ajouter un port, définissez le paramètre pszDataName de cette fonction sur la chaîne L"AddPort ». Pour configurer un port, définissez ce paramètre sur L"ConfigPort ».

Pour plus d’informations, consultez Interface TCPMON Xcv .

Configuration requise

Condition requise	Valeur
En-tête	tcpxcv.h (inclure Tcpxcv.h)

Voir aussi

XcvData

Partager via