Función WSAGetServiceClassNameByClassIdA (winsock2.h)

La función WSAGetServiceClassNameByClassId recupera el nombre del servicio asociado al tipo especificado. Este nombre es el nombre de servicio genérico, como FTP o SNA, y no el nombre de una instancia específica de ese servicio.

Sintaxis

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Parámetros

[in] lpServiceClassId

Puntero al GUID de la clase de servicio.

[out] lpszServiceClassName

Puntero al nombre del servicio.

[in, out] lpdwBufferLength

En la entrada, la longitud del búfer devuelto por lpszServiceClassName, en caracteres. En la salida, la longitud del nombre del servicio copiado en lpszServiceClassName, en caracteres.

Valor devuelto

La función WSAGetServiceClassNameByClassId devuelve un valor de cero si se ejecuta correctamente. De lo contrario, se devuelve el valor SOCKET_ERROR y se puede recuperar un número de error específico llamando a WSAGetLastError.

Código de error	Significado
WSA_INVALID_PARAMETER	El parámetro lpServiceClassId especificado no es válido.
WSA_NOT_ENOUGH_MEMORY	No había memoria suficiente para realizar la operación.
WSAEACCES	La rutina de llamada no tiene privilegios suficientes para acceder a la información.
WSAEFAULT	El búfer especificado al que apunta lpszServiceClassName es demasiado pequeño. Pase un búfer mayor.
WSAENOBUFS	No hay espacio de búfer disponible.
WSAEOPNOTSUPP	No se admite la operación para el tipo de objeto al que se hace referencia. Algunos proveedores de espacios de nombres que no admiten la obtención de información de clase de servicio devuelven este error.
WSANO_DATA	El lpServiceClassId es válido, pero no se encontró ningún dato del tipo solicitado.
WSANOTINITIALISED	No se ha inicializado el WS2_32.DLL. La aplicación debe llamar primero a WSAStartup antes de llamar a cualquier función de Windows Sockets.

Observaciones

Nota

El encabezado winsock2.h define WSAGetServiceClassNameByClassId como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	winsock2.h
biblioteca de	Ws2_32.lib
DLL de	Ws2_32.dll

Consulte también

WSAStartup

funciones winsock

de referencia de Winsock