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
ERROR_INVALID_PARAMETER	Os parâmetros ResourceId ou lpszString são inválidos.
ERROR_INSUFFICIENT_BUFFER	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	Rassapi.h
Biblioteca	Rassapi.lib
DLL	Rassapi.dll

Confira também

Visão geral do RAS (Serviço de Acesso Remoto)

Funções de administração do servidor RAS

LoadLibrary

Globalalloc

Loadstring