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 |
|---|---|
|
La dirección o el búfer especificados por lpRasCtryInfo no son válidos. |
|
El miembro dwCountryId de la estructura a la que apunta lpRasCtryInfo no era un valor válido. |
|
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. |
|
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
Información general sobre el servicio de acceso remoto (RAS)