Función WSAGetServiceClassNameByClassIdA (winsock2.h)

  • Artículo

La función WSAGetServiceClassNameByClassId recupera el nombre del servicio asociado al tipo especificado. Este nombre es el nombre del 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 más grande.
WSAENOBUFS
 No hay espacio en búfer disponible.
WSAEOPNOTSUPP
 La operación no se admite 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
 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winsock2.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

WSAStartup

Funciones winsock

Referencia de Winsock