Función lineGetCountry (tapi.h)

  • Artículo

La función lineGetCountry captura las reglas de marcado almacenadas y otra información relacionada con un país o región especificados, el primer país o región de la lista de países o regiones, o todos los países o regiones.

Sintaxis

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Parámetros

dwCountryID

Identificador de país o región (no el código de país) del país o región para el que se va a obtener información. Si se especifica el valor 1, se obtiene información sobre el primer país o región de la lista de países o regiones. Si se especifica el valor 0, se obtiene información sobre todos los países o regiones (lo que puede requerir una gran cantidad de memoria, 20 KB o más).

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 determinado).

lpLineCountryList

Puntero a una ubicación a la que se carga una estructura LINECOUNTRYLIST . Antes de llamar a lineGetCountry, 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_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.

Requisitos

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

Consulte también

Referencia básica de servicios de telefonía

LINECOUNTRYLIST

Información general de referencia de TAPI 2.2

lineNegotiateAPIVersion