Funzione RasAdminGetErrorString
[Questa funzione viene fornita solo per la compatibilità con le versioni precedenti con Windows NT Server 4.0. Restituisce ERROR_CALL_NOT_IMPLEMENTED in Windows Server 2003. Le applicazioni devono usare la funzione MprAdminGetErrorString .]
La funzione RasAdminGetErrorString recupera una stringa di messaggio che corrisponde a un codice di errore RAS restituito da una delle funzioni di amministrazione del server RAS (RasAdmin). Queste stringhe di messaggio vengono recuperate dal Rasmsg.dll installato come parte di RAS.
Sintassi
DWORD RasAdminGetErrorString(
_In_ UINT ResourceId,
_Out_ WCHAR *lpszString,
_In_ DWORD InBufSize
);
Parametri
-
ResourceId [in]
-
Specifica un codice di errore restituito da una delle funzioni RasAdmin. Questo valore deve essere compreso nell'intervallo di codici di errore da RASBASE a RASBASEEND. Queste sono definite in Raserror.h.
-
lpszString [out]
-
Puntatore a un buffer che riceve il messaggio di errore corrispondente al codice di errore specificato.
-
InBufSize [in]
-
Specifica le dimensioni, in caratteri, del buffer lpszString . I messaggi di errore sono in genere di 80 caratteri o meno; una dimensione del buffer di 512 caratteri è sempre adeguata.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore. Questo valore può essere un ultimo valore di errore impostato dalle funzioni LoadLibrary, GlobalAlloc o LoadString ; oppure può essere uno dei codici di errore seguenti.
Valore | Significato |
---|---|
|
I parametri ResourceId o lpszString non sono validi. |
|
La dimensione specificata dal parametro InBufSize è troppo piccola. |
Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.
Commenti
Le funzioni RasAdmin possono restituire codici di errore non inclusi nell'intervallo supportato dalla funzione RasAdminGetErrorString . Ad esempio, le funzioni RasAdmin possono restituire codici di errore definiti in Lmerr.h e Winerror.h. Prima di chiamare RasAdminGetErrorString, verificare che il codice di errore sia compreso nell'intervallo RASBASE a RASBASEEND, come definito in Raserror.h.
Requisiti
Requisito | Valore |
---|---|
Fine del supporto client |
Windows 2000 Professional |
Fine del supporto server |
Windows 2000 Server |
Intestazione |
|
Libreria |
|
DLL |
|