Função RasAdminGetErrorString
[Essa função é fornecida apenas para compatibilidade com versões anteriores com o Windows NT Server 4.0. Ele retorna ERROR_CALL_NOT_IMPLEMENTED no Windows Server 2003. Os aplicativos devem usar a função MprAdminGetErrorString .]
A função RasAdminGetErrorString recupera uma cadeia de caracteres de mensagem que corresponde a um código de erro RAS retornado por uma das funções rasAdmin (administração do servidor RAS). Essas cadeias de caracteres de mensagem são recuperadas do Rasmsg.dll instalado como parte do RAS.
Sintaxe
DWORD RasAdminGetErrorString(
_In_ UINT ResourceId,
_Out_ WCHAR *lpszString,
_In_ DWORD InBufSize
);
Parâmetros
-
ResourceId [in]
-
Especifica um código de erro retornado por uma das funções RasAdmin. Esse valor deve estar no intervalo de códigos de erro de RASBASE a RASBASEEND. Eles são definidos em Raserror.h.
-
lpszString [out]
-
Ponteiro para um buffer que recebe a mensagem de erro que corresponde ao código de erro especificado.
-
InBufSize [in]
-
Especifica o tamanho, em caracteres, do buffer lpszString . As mensagens de erro normalmente têm 80 caracteres ou menos; um tamanho de buffer de 512 caracteres é sempre adequado.
Valor retornado
Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um código de erro. Esse valor pode ser um último valor de erro definido pelas funções LoadLibrary, GlobalAlloc ou LoadString ; ou pode ser um dos seguintes códigos de erro.
| Valor | Significado |
|---|---|
|
Os parâmetros ResourceId ou lpszString são inválidos. |
|
O tamanho especificado pelo parâmetro InBufSize é muito pequeno. |
Não há informações de erro estendidas para essa função; não chame GetLastError.
Comentários
As funções RasAdmin podem retornar códigos de erro que não estão no intervalo com suporte da função RasAdminGetErrorString . Por exemplo, as funções RasAdmin podem retornar códigos de erro definidos em Lmerr.h e Winerror.h. Antes de chamar RasAdminGetErrorString, verifique se o código de erro está no intervalo RASBASE para RASBASEEND, conforme definido em Raserror.h.
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte ao cliente |
Windows 2000 Professional |
| Fim do suporte ao servidor |
Windows 2000 Server |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|