Función RasGetSubEntryPropertiesA (ras.h)
La función RasGetSubEntryProperties recupera información sobre un subentry para una entrada de libreta de teléfono especificada.
Sintaxis
DWORD RasGetSubEntryPropertiesA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] DWORD unnamedParam3,
[in, out] LPRASSUBENTRYA unnamedParam4,
[in, out] LPDWORD unnamedParam5,
[in] LPBYTE unnamedParam6,
[in] LPDWORD unnamedParam7
);
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 terminadanull que especifica el nombre de una entrada existente en la libreta de teléfonos.
[in] unnamedParam3
Especifica el índice basado en uno del subentry.
[in, out] unnamedParam4
Puntero a la estructura de RASSUBENTRY seguida de bytes adicionales para la lista de números de teléfono alternativo, si hay una.
En la salida, la estructura recibe información sobre el subentry especificado.
En la entrada, el miembro dwSize especifica el tamaño de la estructura. El tamaño identifica la versión de la estructura. Obtenga este tamaño mediante sizeof(RASSUBENTRY).
Este parámetro puede ser null.
[in, out] unnamedParam5
Puntero a una variable que especifica, en entrada, el tamaño, en bytes, del búfer de lpRasSubEntry.
En la salida, la variable recibe el número de bytes devueltos o el número de bytes necesarios si el búfer es demasiado pequeño.
Este parámetro puede ser NULL si lpRasSubEntry es NULL.
[in] unnamedParam6
Puntero a un bloque de configuración del dispositivo TAPI. Este parámetro no se usa actualmente. El autor de la llamada debe pasar NULL para este parámetro. Para obtener más información sobre los bloques de configuración de dispositivos TAPI, consulte la función lineGetDevConfig.
[in] unnamedParam7
Puntero a un DWORD que especifica el tamaño del bloque de configuración del dispositivo TAPI. Este parámetro no se usa actualmente. El autor de la llamada debe pasar NULL para este parámetro.
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. |
|
La dirección o el búfer especificados por lpRasSubEntry no es válido. |
|
El búfer de lpRasSubEntry es demasiado pequeño. La variable lpdwcb |
|
La libreta de teléfonos está dañada o faltan componentes. |
|
La entrada de la libreta de teléfonos no existe. |
Observaciones
Una entrada de libreta de teléfono ras puede tener cero o más subentries, cada uno de los cuales consta mínimamente de un dispositivo y un número de teléfono. Una entrada de libreta de teléfonos con varios subentries se puede configurar para marcar la primera entrada disponible o todas las entradas cuando se marque la entrada.
Use la función RasGetEntryProperties para recuperar una estructura de RASENTRY que contiene información sobre los subetiquetas de una entrada de libreta de teléfonos. El miembro dwSubEntries indica el número de subintentos y el miembro dwDialMode indica la configuración de marcado.
Nota
El encabezado ras.h define RasGetSubEntryProperties 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 |