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 interfaz de programación de aplicaciones de telefonía (TAPI) identificadores de país o región, 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 de 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 dwSize miembro 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 es 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 es válido.
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 de 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.

Observaciones

Para enumerar la información de todos los países o regiones de la lista de telefonía de Windows, establezca el dwCountryId miembro del de RASCTRYINFO en 1 en la llamada inicial 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 dwNextCountryID miembro 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	ras.h
biblioteca de	Rasapi32.lib
DLL de	Rasapi32.dll

Consulte también

RASCTRYINFO

información general del servicio de acceso remoto (RAS)

funciones del servicio de acceso remoto