Función lineGetCountry (tapi.h)
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.
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