ADsSetLastError 함수(adshlp.h)

ADsSetLastError는 호출 스레드에 대한 마지막 오류 코드 값을 설정합니다. 디렉터리 서비스 공급자는 이 함수를 사용하여 확장 오류를 설정할 수 있습니다. 함수는 스레드별 데이터 구조에 오류 데이터를 저장합니다. ADsSetLastError 는 SetLastError 함수와 유사하게 작동합니다.

구문

void ADsSetLastError(
  [in] DWORD   dwErr,
  [in] LPCWSTR pszError,
  [in] LPCWSTR pszProvider
);

매개 변수

[in] dwErr

형식:DWORD

발생한 오류 코드입니다. Windows에서 정의한 오류인 경우 pszError 는 무시됩니다. 이 ERROR_EXTENDED_ERROR 공급자가 보고할 네트워크별 오류가 있음을 나타냅니다.

[in] pszError

형식: LPWSTR

네트워크별 오류를 설명하는 null로 끝나는 유니코드 문자열입니다.

[in] pszProvider

형식: LPWSTR

오류를 발생시킨 ADSI 공급자의 이름을 지정하는 null로 끝나는 유니코드 문자열입니다.

반환 값

없음

설명

ADSI 공급자의 사용자 지정 구현(예: LDAP 공급자)에서는 다음과 같이 작업 오류 메시지를 설정할 수 있습니다.

ADsSetLastError(HRESULT_FROM_WIN32(ERROR_DS_OPERATIONS_ERROR),
                L"ERROR_DS_OPERATIONS_ERROR",
                L"LDAP Provider");

사용자는 다음 코드 예제를 사용하여 이 작업 코드를 검사할 수 있습니다.

DWORD dwLastError;
WCHAR szErrorBuf[MAX_PATH];
WCHAR szNameBuf[MAX_PATH];
// Get extended error value.
HRESULT hr_return =S_OK;
hr_return = ADsGetLastError( &dwLastError,
                               szErrorBuf,
                               MAX_PATH,
                               szNameBuf,
                               MAX_PATH);
if (SUCCEEDED(hr_return))
{
    wprintf(L"Error Code: %d\n Error Text: %ws\n Provider: %ws\n", dwLastError, szErrorBuf, szNameBuf);
}

이전 코드 예제에서는 위에 설정된 작업 오류 코드에 대해 다음 출력을 생성합니다.

Error value: 80072020
Error Text: ERROR_DS_OPERATIONS_ERROR
Provider: LDAP Provider

오류를 설정할 때 HRESULT_FROM_WIN32 매크로를 호출하지 않고 ERROR_DS_OPERATIONS_ERROR 사용하면 다음 출력이 반환됩니다.

Error value: 2020
Error Text: ERROR_DS_OPERATIONS_ERROR
Provider: LDAP Provider

요구 사항

추가 정보

ADSI 오류 코드

ADSI 함수

ADsGetLastError

SetLastError