Función RasGetEntryPropertiesA (ras.h)
La función RasGetEntryProperties recupera las propiedades de una entrada de libreta de teléfonos.
Sintaxis
DWORD RasGetEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in, out] LPRASENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPBYTE unnamedParam5,
[in, out] LPDWORD unnamedParam6
);
Parámetros
[in] unnamedParam1
Puntero a un cadena terminada en nullque especifica la ruta de acceso completa y el nombre de archivo de un archivo de libreta telefónica (PBK). Si este parámetro es NULL, la función usa el archivo de libreta de teléfono predeterminado actual. El archivo de libreta de teléfonos predeterminado es el seleccionado por el usuario en la hoja de propiedades preferencias de usuario de
Windows Me/98/95: Este parámetro siempre debe ser NULL. Las redes de acceso telefónico almacenan entradas de libreta de teléfonos en el registro en lugar de en un archivo de libreta de teléfonos.
[in] unnamedParam2
Puntero a un cadena terminada en nullque especifica un nombre de entrada existente. Si se especifica una cadena vacía, la función devuelve valores predeterminados en los búferes a los que apunta el lpRasEntry y parámetros lpbDeviceInfo.
[in, out] unnamedParam3
Puntero a una estructura de RASENTRY seguida de bytes adicionales para la lista de números de teléfono alternativos, si hay una.
En la salida, la estructura recibe los datos de conexión asociados a la entrada de la libreta de teléfono especificada por el parámetro lpszEntry.
En la entrada, establezca el dwSize miembro de la estructura en sizeof(RASENTRY) para identificar la versión de la estructura.
Este parámetro puede ser null.
Windows Me/98 y Windows 95 OSR2: La capa de Microsoft para Unicode no admite dwAlternateOffset en RASENTRY.
[in, out] unnamedParam4
Puntero a una variable que, en la entrada, especifica el tamaño, en bytes, del búfer de lpRasEntry.
En la salida, esta variable recibe el número de bytes necesarios.
Este parámetro puede ser NULL si el parámetro de lpRasEntry es NULL.
Para determinar el tamaño de búfer necesario, llame a rasGetEntryProperties con lpRasEntry establecido en NULL y *lpdwEntryInfoSize establecido en cero. La función devuelve el tamaño de búfer necesario en *lpdwEntryInfoSize.
[out] unnamedParam5
Este parámetro ya no se usa. La función de llamada debe establecer este parámetro en NULL.
Windows Me/98/95: puntero a un búfer que recibe información de configuración específica del dispositivo. No manipule directamente esta información opaca del dispositivo TAPI. Para obtener más información sobre la configuración del dispositivo TAPI, consulte la función lineGetDevConfig en la referencia del programador de TAPI en el SDK de plataforma.
Este parámetro puede ser null.
[in, out] unnamedParam6
Este parámetro no se usa. La función de llamada debe establecer este parámetro en NULL.
Windows Me/98/95: Puntero a una variable que, en la entrada, especifica el tamaño, en bytes, del búfer especificado por el parámetro lpbDeviceInfo.
En la salida, esta variable recibe el número de bytes necesarios.
Este parámetro puede ser NULL si el parámetro lpbDeviceInfoNULL.
Para determinar el tamaño de búfer necesario, llame a RasGetEntryProperties con lpbDeviceInfo establecido en NULL y *lpdwDeviceInfoSize establecido en cero. La función devuelve el tamaño de búfer necesario en *lpdwDeviceInfoSize.
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 |
|---|---|
|
Se llamó a la función con un parámetro no válido. |
|
El valor del miembro dwSize del lpRasEntry es demasiado pequeño. |
|
La dirección o el búfer especificados por lpRasEntry no es válido. |
|
El tamaño del búfer indicado en lpdwEntryInfoSize es demasiado pequeño. |
|
La entrada de la libreta de teléfonos no existe o el archivo de la libreta de teléfonos está dañado o tiene componentes que faltan. |
Observaciones
Nota
El encabezado ras.h define RasGetEntryProperties 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