WNetGetLastErrorA 함수(winnetwk.h)

WNetGetLastError 함수는 WNet 함수에서 설정한 가장 최근의 확장된 오류 코드를 검색합니다. 네트워크 공급자가 이 오류 코드를 보고했습니다. 일반적으로 SDK 헤더 파일 WinError.h에 포함된 오류 중 하나가 아닙니다.

구문

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

매개 변수

[out] lpError

네트워크 공급자가 보고한 오류 코드를 수신하는 변수에 대한 포인터입니다. 오류 코드는 네트워크 공급자와 관련이 있습니다.

[out] lpErrorBuf

오류를 설명하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.

[in] nErrorBufSize

lpErrorBuf 매개 변수가 가리키는 버퍼의 크기(문자)입니다. 버퍼가 오류 문자열에 비해 너무 작으면 문자열이 잘리지만 여전히 null로 종료됩니다. 256자 이상의 버퍼를 사용하는 것이 좋습니다.

[out] lpNameBuf

오류를 발생시킨 네트워크 공급자를 식별하는 null로 종료된 문자열을 수신하는 버퍼에 대한 포인터입니다.

[in] nNameBufSize

lpNameBuf 매개 변수가 가리키는 버퍼의 크기(문자)입니다. 버퍼가 오류 문자열에 비해 너무 작으면 문자열이 잘리지만 여전히 null로 종료됩니다.

반환 값

함수가 성공하고 네트워크 공급자가 보고한 마지막 오류를 가져오면 반환 값이 NO_ERROR.

호출자가 잘못된 버퍼를 제공하면 반환 값이 ERROR_INVALID_ADDRESS.

설명

WNetGetLastError 함수는 네트워크 공급자와 관련된 오류를 검색합니다. WNet 함수가 ERROR_EXTENDED_ERROR 반환할 때 WNetGetLastError 를 호출할 수 있습니다.

GetLastError 함수와 마찬가지로 WNetGetLastError는 스레드별로 유지 관리되는 확장된 오류 정보를 반환합니다. GetLastError와 달리 WNetGetLastError 함수는 WinError.h의 기존 오류 코드에 설명되지 않은 오류를 보고하기 위한 문자열을 반환할 수 있습니다.

WNetGetLastError 함수를 호출하는 애플리케이션 정의 오류 처리기를 사용하는 방법에 대한 자세한 내용은 네트워크 오류 검색을 참조하세요.

요구 사항

추가 정보

WNet(Windows 네트워킹) 개요

Windows 네트워킹 함수