Función RasGetCountryInfoA (ras.h)

La función RasGetCountryInfo recupera información de marcado específica del país o región de la lista de países o regiones de telefonía de Windows.

Para obtener más información sobre la información de marcado específica de país o región y los identificadores de país o región específicos de la interfaz de programación de aplicaciones de telefonía (TAPI), consulte la parte TAPI del Kit de desarrollo de software de plataforma (SDK).

Sintaxis

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

Parámetros

[in, out] unnamedParam1

Puntero a una estructura RASCTRYINFO que, en la salida, recibe la información de marcado específica del país o región seguida de bytes adicionales para una cadena de descripción de país o región.

En la entrada, establezca el miembro dwSize de la estructura en sizeof(RASCTRYINFO) para identificar la versión de la estructura. Además, establezca el miembro dwCountryId en el identificador de país o región de TAPI del país o región para el que se va a obtener información.

Asigne al menos 256 bytes para el búfer.

[in, out] unnamedParam2

Puntero a una variable que, en la entrada, especifica el tamaño, en bytes, del búfer al que apunta el parámetro lpRasCtryInfo .

En la salida, esta variable recibe el número de bytes necesarios.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error o un valor de Códigos de error de enrutamiento y acceso remoto o Winerror.h.

Valor	Significado
ERROR_INVALID_USER_BUFFER	La dirección o el búfer especificados por lpRasCtryInfo no son válidos.
ERROR_INVALID_PARAMETER	El miembro dwCountryId de la estructura a la que apunta lpRasCtryInfo no era un valor válido.
ERROR_BUFFER_TOO_SMALL	El tamaño del búfer lpRasCtryInfo especificado por el parámetro lpdwSize no era lo suficientemente grande como para almacenar la información del país o región identificado por el miembro dwCountryId . La función devuelve el tamaño de búfer necesario en la variable a la que apunta lpdwSize.
ERROR_TAPI_CONFIGURATION	La información del subsistema TAPI estaba dañada.

Comentarios

Para enumerar la información de todos los países o regiones de la lista de telefonía de Windows, establezca el miembro dwCountryId de la estructura RASCTRYINFO en 1 en la llamada inicial a RasGetCountryInfo . Esto hace que la función devuelva información para el primer país o región de la lista. El valor devuelto en el miembro dwNextCountryID es el identificador de país o región del siguiente país o región de la lista. Use este valor en llamadas repetidas a RasGetCountryInfo hasta que dwNextCountryID devuelva cero, lo que indica el último país o región de la lista.

Nota

El encabezado ras.h define RasGetCountryInfo 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ras.h
Library	Rasapi32.lib
Archivo DLL	Rasapi32.dll

Consulte también

RASCTRYINFO

Información general sobre el servicio de acceso remoto (RAS)

Funciones del Servicio de acceso remoto