Función lineGetProviderList (tapi.h)

  • Artículo

La función lineGetProviderList devuelve una lista de proveedores de servicios instalados actualmente en el sistema de telefonía.

Sintaxis

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Parámetros

dwAPIVersion

Versión más alta de TAPI compatible con la aplicación (no necesariamente el valor negociado por lineNegotiateAPIVersion en algún dispositivo de línea concreto).

lpProviderList

Puntero a una ubicación de memoria donde TAPI puede devolver una estructura LINEPROVIDERLIST . Antes de llamar a lineGetProviderList, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .
 

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.

Requisitos

   
Plataforma de destino Windows
Encabezado tapi.h
Library Tapi32.lib
Archivo DLL Tapi32.dll

Consulte también

LINEPROVIDERLIST

Funciones complementarias del servicio de línea

Introducción a la referencia de TAPI 2.2

lineNegotiateAPIVersion