RasAdminGetErrorString 함수

[이 함수는 Windows NT Server 4.0과의 이전 버전과의 호환성을 위해서만 제공됩니다. Windows Server 2003에서 ERROR_CALL_NOT_IMPLEMENTED 반환합니다. 애플리케이션은 MprAdminGetErrorString 함수를 사용해야 합니다.]

RasAdminGetErrorString 함수는 RAS 서버 관리(RasAdmin) 함수 중 하나에서 반환된 RAS 오류 코드에 해당하는 메시지 문자열을 검색합니다. 이러한 메시지 문자열은 RAS의 일부로 설치된 Rasmsg.dll 검색됩니다.

구문

DWORD RasAdminGetErrorString(
  _In_  UINT  ResourceId,
  _Out_ WCHAR *lpszString,
  _In_  DWORD InBufSize
);

매개 변수

ResourceId [in]

RasAdmin 함수 중 하나에서 반환되는 오류 코드를 지정합니다. 이 값은 RASBASE에서 RASBASEEND까지의 오류 코드 범위에 있어야 합니다. 이러한 항목은 Raserror.h에 정의되어 있습니다.

lpszString [out]

지정된 오류 코드에 해당하는 오류 메시지를 수신하는 버퍼에 대한 포인터입니다.

InBufSize [in]

lpszString 버퍼의 크기를 문자 단위로 지정합니다. 오류 메시지는 일반적으로 80자 이하입니다. 버퍼 크기는 항상 512자입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 오류 코드입니다. 이 값은 LoadLibrary, GlobalAlloc 또는 LoadString 함수에서 설정한 마지막 오류 값일 수 있습니다. 또는 다음 오류 코드 중 하나일 수 있습니다.

값	의미
ERROR_INVALID_PARAMETER	ResourceId 또는 lpszString 매개 변수가 잘못되었습니다.
ERROR_INSUFFICIENT_BUFFER	InBufSize 매개 변수에 지정된 크기가 너무 작습니다.

이 함수에 대한 확장된 오류 정보는 없습니다. GetLastError를 호출하지 마세요.

설명

RasAdmin 함수는 RasAdminGetErrorString 함수에서 지원하는 범위에 없는 오류 코드를 반환할 수 있습니다. 예를 들어 RasAdmin 함수는 Lmerr.h 및 Winerror.h에 정의된 오류 코드를 반환할 수 있습니다. RasAdminGetErrorString을 호출하기 전에 Raserror.h에 정의된 대로 오류 코드가 RASBASE에서 RASBASEEND까지의 범위에 있는지 확인합니다.

요구 사항

요구 사항	값
클라이언트 지원 종료	Windows 2000 Professional
서버 지원 종료	Windows 2000 Server
헤더	Rassapi.h
라이브러리	Rassapi.lib
DLL	Rassapi.dll

추가 정보

RAS(원격 액세스 서비스) 개요

RAS 서버 관리 함수

LoadLibrary

GlobalAlloc

LoadString