WSAPROTOCOL_INFOW struttura (winsock2.h)

La struttura WSAPROTOCOL_INFOW viene usata per archiviare o recuperare informazioni complete per un determinato protocollo. Il nome del protocollo è rappresentato come matrice di caratteri Unicode.

Sintassi

typedef struct _WSAPROTOCOL_INFOW {
  DWORD            dwServiceFlags1;
  DWORD            dwServiceFlags2;
  DWORD            dwServiceFlags3;
  DWORD            dwServiceFlags4;
  DWORD            dwProviderFlags;
  GUID             ProviderId;
  DWORD            dwCatalogEntryId;
  WSAPROTOCOLCHAIN ProtocolChain;
  int              iVersion;
  int              iAddressFamily;
  int              iMaxSockAddr;
  int              iMinSockAddr;
  int              iSocketType;
  int              iProtocol;
  int              iProtocolMaxOffset;
  int              iNetworkByteOrder;
  int              iSecurityScheme;
  DWORD            dwMessageSize;
  DWORD            dwProviderReserved;
  WCHAR            szProtocol[WSAPROTOCOL_LEN + 1];
} WSAPROTOCOL_INFOW, *LPWSAPROTOCOL_INFOW;

Members

dwServiceFlags1

Tipo: DWORD

Maschera bit che descrive i servizi forniti dal protocollo. I valori possibili per questo membro sono definiti nel file di intestazione Winsock2.h .

I valori seguenti sono possibili.

dwServiceFlags2

Tipo: DWORD

Riservato per le definizioni di attributi del protocollo aggiuntive.

dwServiceFlags3

Tipo: DWORD

Riservato per le definizioni di attributi del protocollo aggiuntive.

dwServiceFlags4

Tipo: DWORD

Riservato per le definizioni di attributi del protocollo aggiuntive.

dwProviderFlags

Tipo: DWORD

Set di flag che forniscono informazioni sul modo in cui questo protocollo è rappresentato nel catalogo Winsock. I valori possibili per questo membro sono definiti nel file di intestazione Winsock2.h .

I valori seguenti sono possibili.

ProviderId

Tipo: GUID

Identificatore univoco globale (GUID) assegnato al provider dal fornitore del provider di servizi. Questo valore è utile per le istanze in cui più provider di servizi è in grado di implementare un protocollo specifico. Un'applicazione può usare il membro ProviderId per distinguere tra provider che potrebbero altrimenti essere indistinguishable.

dwCatalogEntryId

Tipo: DWORD

Identificatore univoco assegnato dal WS2_32.DLL per ogni struttura WSAPROTOCOL_INFO .

ProtocolChain

Tipo: WSAPROTOCOLCHAIN

Struttura WSAPROTOCOLCHAIN associata al protocollo. Se la lunghezza della catena è 0 , questa WSAPROTOCOL_INFO voce rappresenta un protocollo a livelli con Windows Sockets 2 SPI sia come bordi superiore che inferiore. Se la lunghezza della catena è uguale a 1, questa voce rappresenta un protocollo di base il cui identificatore di voce del catalogo si trova nel membro dwCatalogEntryId della struttura WSAPROTOCOL_INFO . Se la lunghezza della catena è maggiore di 1, questa voce rappresenta una catena di protocolli costituita da uno o più protocolli a livelli sopra un protocollo di base. Gli identificatori di voce del catalogo corrispondenti si trovano nella matrice ProtocolChain.ChainEntries a partire dal protocollo a livelli nella parte superiore (l'elemento zero nella matrice ProtocolChain.ChainEntries) e terminando con il protocollo di base. Per altre informazioni sulle catene di protocollo, vedere la specifica dell'interfaccia del provider di servizi Windows Sockets 2.

iVersion

Tipo: int

Identificatore della versione del protocollo.

iAddressFamily

Tipo: int

Valore da passare come parametro della famiglia di indirizzi alla funzione socket o WSASocket per aprire un socket per questo protocollo. Questo valore definisce anche in modo univoco la struttura di un indirizzo di protocollo per un sockaddr usato dal protocollo.

In Windows SDK rilasciato per Windows Vista e versioni successive, i valori possibili per la famiglia di indirizzi sono definiti nel file di intestazione Ws2def.h . Si noti che il file di intestazione Ws2def.h viene incluso automaticamente in Winsock2.h e non deve mai essere usato direttamente.

Nelle versioni di Platform SDK per Windows Server 2003 e versioni precedenti, i valori possibili per la famiglia di indirizzi sono definiti nel file di intestazione Winsock2.h .

I valori attualmente supportati sono AF_INET o AF_INET6, ovvero i formati della famiglia di indirizzi Internet per IPv4 e IPv6. Altre opzioni per la famiglia di indirizzi (AF_NETBIOS per l'uso con NetBIOS, ad esempio) sono supportate se è installato un provider di servizi Windows Sockets per la famiglia di indirizzi. Si noti che i valori per la famiglia di indirizzi AF_ e le costanti della famiglia di protocolli di PF_ sono identiche (ad esempio, AF_INET e PF_INET), in modo che sia possibile usare una costante.

La tabella seguente elenca i valori comuni per la famiglia di indirizzi, anche se sono possibili molti altri valori.

iMaxSockAddr

Tipo: int

Lunghezza massima dell'indirizzo, in byte.

iMinSockAddr

Tipo: int

Lunghezza minima dell'indirizzo, in byte.

iSocketType

Tipo: int

Valore da passare come parametro di tipo socket alla funzione socket o WSASocket per aprire un socket per questo protocollo. I valori possibili per il tipo di socket sono definiti nel file di intestazione Winsock2.h .

La tabella seguente elenca i valori possibili per il membro iSocketType supportato per Windows Sockets 2:

iProtocol

Tipo: int

Valore da passare come parametro del protocollo alla funzione socket o WSASocket per aprire un socket per questo protocollo. Le opzioni possibili per il membro iProtocol sono specifiche della famiglia di indirizzi e del tipo di socket specificati.

In Windows SDK rilasciato per Windows Vista e versioni successive, questo membro può essere uno dei valori del tipo di enumerazione IPPROTO definito nel file di intestazione Ws2def.h . Si noti che il file di intestazione Ws2def.h viene automaticamente incluso in Winsock2.h e non deve mai essere usato direttamente.

Nelle versioni di Platform SDK per Windows Server 2003 e versioni precedenti, i valori possibili per il membro iProtocol sono definiti nei file di intestazione Winsock2.h e Wsrm.h .

La tabella seguente elenca i valori comuni per iProtocol anche se sono possibili molti altri valori.

iProtocolMaxOffset

Tipo: int

Valore massimo che può essere aggiunto al membro iProtocol quando si specifica un valore per il parametro del protocollo in socket e WSASocket. Non tutti i protocolli consentono un intervallo di valori. Quando questo è il caso iProtocolMaxOffset è zero.

iNetworkByteOrder

Tipo: int

Attualmente questi valori sono costanti manifesto (BIGENDIAN e LITTLEENDIAN) che indicano rispettivamente big-endian o little-endian con i valori 0 e 1.

iSecurityScheme

Tipo: int

Tipo di schema di sicurezza utilizzato (se presente). Il valore SECURITY_PROTOCOL_NONE (0) viene usato per i protocolli che non incorporano le disposizioni di sicurezza.

dwMessageSize

Tipo: DWORD

Dimensione massima del messaggio, in byte, supportata dal protocollo. Questa è la dimensione massima che può essere inviata da qualsiasi interfaccia locale dell'host. Per i protocolli che non supportano il frame dei messaggi, il valore massimo effettivo che può essere inviato a un determinato indirizzo può essere inferiore. Non è previsto alcun provisioning standard per determinare la dimensione massima dei messaggi in ingresso. Vengono definiti i valori speciali seguenti.

dwProviderReserved

Tipo: DWORD

Riservato per l'uso da parte dei provider di servizi.

szProtocol[WSAPROTOCOL_LEN + 1]

Tipo: WCHAR[WSAPROTOCOL_LEN+1]

Matrice di caratteri Unicode che contiene un nome leggibile che identifica il protocollo, ad esempio "MSAFD Tcpip [UDP/IP]". Il numero massimo di caratteri consentiti è WSAPROTOCOL_LEN, che è definito come 255.

Commenti

Requisiti

Vedi anche

WSAPROTOCOLCHAIN

WSAPROTOCOL_INFO

WSASend

WSASendTo

WSASocket

WSCEnumProtocols

WSCEnumProtocols32

getsockopt

Socket