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
ERROR_INVALID_PARAMETER
I parametri ResourceId o lpszString non sono validi.
ERROR_INSUFFICIENT_BUFFER
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
Rassapi.h
Libreria
Rassapi.lib
DLL
Rassapi.dll

Vedi anche

Panoramica del servizio accesso remoto (RAS)

Funzioni di amministrazione del server RAS

LoadLibrary

Globalalloc

LoadString