Función RasAdminGetErrorString
[Esta función solo se proporciona para la compatibilidad con versiones anteriores con Windows NT Server 4.0. Devuelve ERROR_CALL_NOT_IMPLEMENTED en Windows Server 2003. Las aplicaciones deben usar la función MprAdminGetErrorString .]
La función RasAdminGetErrorString recupera una cadena de mensaje que corresponde a un código de error RAS devuelto por una de las funciones de administración del servidor RAS (RasAdmin). Estas cadenas de mensaje se recuperan de la Rasmsg.dll que se instala como parte de RAS.
Sintaxis
DWORD RasAdminGetErrorString(
_In_ UINT ResourceId,
_Out_ WCHAR *lpszString,
_In_ DWORD InBufSize
);
Parámetros
-
ResourceId [in]
-
Especifica un código de error devuelto por una de las funciones RasAdmin. Este valor debe estar en el intervalo de códigos de error de RASBASE a RASBASEEND. Se definen en Raserror.h.
-
lpszString [out]
-
Puntero a un búfer que recibe el mensaje de error que corresponde al código de error especificado.
-
InBufSize [in]
-
Especifica el tamaño, en caracteres, del búfer lpszString . Los mensajes de error suelen tener 80 caracteres o menos; Un tamaño de búfer de 512 caracteres siempre es adecuado.
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 un código de error. Este valor puede ser un último valor de error establecido por las funciones LoadLibrary, GlobalAlloc o LoadString ; o puede ser uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
Los parámetros ResourceId o lpszString no son válidos. |
|
El tamaño especificado por el parámetro InBufSize es demasiado pequeño. |
No hay información de error extendida para esta función; no llame a GetLastError.
Comentarios
Las funciones RasAdmin pueden devolver códigos de error que no están en el intervalo admitidos por la función RasAdminGetErrorString . Por ejemplo, las funciones RasAdmin pueden devolver códigos de error definidos en Lmerr.h y Winerror.h. Antes de llamar a RasAdminGetErrorString, compruebe que el código de error está en el intervalo RASBASE a RASBASEEND, tal como se define en Raserror.h.
Requisitos
| Requisito | Value |
|---|---|
| Fin de compatibilidad de cliente |
Windows 2000 Professional |
| Fin de compatibilidad de servidor |
Windows 2000 Server |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|