Поделиться через


Функция EnumProtocolsA (nspapi.h)

Функция EnumProtocols извлекает сведения об определенном наборе сетевых протоколов, которые активны на локальном узле.

Примечание Функция EnumProtocols — это специальное расширение корпорации Майкрософт для спецификации Windows Sockets 1.1. Эта функция является устаревшей. Для удобства разработчиков Windows Sockets 1.1 приведен справочный материал. Функция WSAEnumProtocols предоставляет эквивалентные функции в Windows Sockets 2.
 

Синтаксис

INT EnumProtocolsA(
  [in, optional] LPINT   lpiProtocols,
  [out]          LPVOID  lpProtocolBuffer,
  [in, out]      LPDWORD lpdwBufferLength
);

Параметры

[in, optional] lpiProtocols

Указатель на массив идентификаторов протокола, завершающийся значением NULL. Функция EnumProtocols извлекает сведения о протоколах, указанных в этом массиве.

Если lpiProtocols имеет значение NULL, функция получает сведения обо всех доступных протоколах.

Определяются следующие значения идентификаторов протокола.

Значение Значение
IPPROTO_TCP
Протокол TCP— протокол потока, ориентированный на подключение.
IPPROTO_UDP
Протокол пользовательской датаграммы (UDP), протокол датаграммы без подключения.
ISOPROTO_TP4
Транспортный протокол, ориентированный на подключение ISO.
NSPROTO_IPX
Протокол IPX, протокол датаграммы без подключения.
NSPROTO_SPX
Протокол вирционированного обмена пакетами (SPX), протокол потока, ориентированный на подключение.
NSPROTO_SPXII
Протокол вирмуляции (SPX) версии 2, протокол потока, ориентированный на подключение.

[out] lpProtocolBuffer

Указатель на буфер, который функция заполняет массивом PROTOCOL_INFO структур данных.

[in, out] lpdwBufferLength

Указатель на переменную, которая во входных данных указывает размер буфера, на который указывает lpProtocolBuffer, в байтах.

В выходных данных функция устанавливает для этой переменной минимальный размер буфера, необходимый для получения всех запрошенных сведений. Для успешного выполнения функции буфер должен быть не ниже этого размера.

Возвращаемое значение

Если функция выполнена успешно, возвращаемым значением будет число PROTOCOL_INFO структур данных, записанных в буфер, на который указывает lpProtocolBuffer.

Если функция завершается сбоем, возвращается значение SOCKET_ERROR(–1). Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError, который возвращает следующий расширенный код ошибки.

Код ошибки Значение
ERROR_INSUFFICIENT_BUFFER
Буфер, на который указывает lpProtocolBuffer, был слишком мал для получения всех соответствующих структур PROTOCOL_INFO . Вызовите функцию с буфером, размером не менее, чем значение, возвращаемое в *lpdwBufferLength.

Комментарии

В следующем примере кода функция EnumProtocols извлекает сведения обо всех протоколах, доступных в системе. Затем код более подробно анализирует каждый из протоколов.

#define WIN32_LEAN_AND_MEAN

#include <windows.h>
#include <winsock2.h>
#include <ws2tcpip.h>
#include <Nspapi.h>
#include <stdlib.h>
#include <stdio.h>


// Need to link with Ws2_32.lib and Mswsock.lib
#pragma comment (lib, "Ws2_32.lib")
#pragma comment (lib, "Mswsock.lib")

int FindProtocol(BOOL Reliable, 
    BOOL MessageOriented, BOOL StreamOriented, 
    BOOL Connectionless, DWORD *ProtocolUsed); 

int __cdecl main(int argc, char **argv)
{
    WSADATA wsaData;

    int ProtocolError = SOCKET_ERROR;
    int iResult;
    
    BOOLEAN bReliable = FALSE;
    BOOLEAN bMessageOriented = FALSE;
    BOOLEAN bStreamOriented = TRUE;
    BOOLEAN bConnectionless = FALSE;
    DWORD *pProtocols = NULL;
    
    // Validate the parameters
    if (argc != 2) {
        printf("usage: %s servicename\n", argv[0]);
        return 1;
    }

    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2,2), &wsaData);
    if (iResult != 0) {
        printf("WSAStartup failed with error: %d\n", iResult);
        return 1;
    }
    
    ProtocolError = FindProtocol( bReliable, bMessageOriented,
        bStreamOriented, bConnectionless, pProtocols);
    if (ProtocolError == SOCKET_ERROR) {
        printf("Unable to find a protocol to support the parameters requested\n");
        return 1;
    }
    
    // Connect to the servicename ...    
    
    return 0;

}

#define MAX_PROTOCOLS 1024

int FindProtocol ( 
    BOOL Reliable, 
    BOOL MessageOriented, 
    BOOL StreamOriented, 
    BOOL Connectionless, 
    DWORD *ProtocolUsed 
    ) 
{ 
    // local variables 
    INT protocols[MAX_PROTOCOLS+1]; 
    BYTE buffer[2048]; 
    DWORD bytesRequired; 
    INT err; 
    PPROTOCOL_INFO protocolInfo; 
    INT protocolCount; 
    INT i; 
    DWORD protocolIndex; 
//    PCSADDR_INFO csaddrInfo; 
//    INT addressCount; 
//    SOCKET s; 
 
    // First look up the protocols installed on this computer. 
    // 
    bytesRequired = sizeof(buffer); 
    err = EnumProtocols( NULL, buffer, &bytesRequired ); 
    if ( err <= 0 ) 
        return SOCKET_ERROR; 
 
    // Walk through the available protocols and pick out the ones which 
    // support the desired characteristics. 
    // 
    protocolCount = err; 
    protocolInfo = (PPROTOCOL_INFO)buffer; 
 
    for ( i = 0, protocolIndex = 0; 
        i < protocolCount && protocolIndex < MAX_PROTOCOLS; 
        i++, protocolInfo++ ) { 
 
        // If connection-oriented support is requested, then check if 
        // supported by this protocol.  We assume here that connection- 
        // oriented support implies fully reliable service. 
        // 
 
        if ( Reliable ) { 
            // Check to see if the protocol is reliable.  It must 
            // guarantee both delivery of all data and the order in 
            // which the data arrives. 
            // 
            if ( (protocolInfo->dwServiceFlags & 
                    XP_GUARANTEED_DELIVERY) == 0 
                || 
                    (protocolInfo->dwServiceFlags & 
                    XP_GUARANTEED_ORDER) == 0 ) { 
 
                continue; 
            } 
 
            // Check to see that the protocol matches the stream/message 
            // characteristics requested. 
            // 
            if ( StreamOriented && 
                (protocolInfo->dwServiceFlags & XP_MESSAGE_ORIENTED) 
                    != 0 && 
                (protocolInfo->dwServiceFlags & XP_PSEUDO_STREAM) 
                     == 0 ) { 
                continue; 
            } 
 
            if ( MessageOriented && 
                    (protocolInfo->dwServiceFlags & XP_MESSAGE_ORIENTED) 
                              == 0 ) { 
                continue; 
            } 
 
        } 
        else if ( Connectionless ) { 
            // Make sure that this is a connectionless protocol. 
            // 
            if ( (protocolInfo->dwServiceFlags & XP_CONNECTIONLESS) 
                     != 0 ) 
                continue; 
        } 
 
        // This protocol fits all the criteria.  Add it to the list of 
        // protocols in which we're interested. 
        // 
        protocols[protocolIndex++] = protocolInfo->iProtocol; 
     }

     *ProtocolUsed = (INT) protocolIndex;
     return 0;
}

Примечание

Заголовок nspapi.h определяет EnumProtocols в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header nspapi.h
Библиотека Mswsock.lib
DLL Mswsock.dll

См. также раздел

GetAddressByName

PROTOCOL_INFO

Функции Winsock

Справочник по Winsock