Udostępnij za pośrednictwem


Rozszerzone komunikaty o błędach ADSI

Oprócz wartości HRESULT kilku dostawców systemu ADSI (głównie LDAP) zwraca dodatkowe dane o błędach dla operacji wykonywanych przez następujące interfejsy:

Częścią takich rozszerzonych danych o błędzie jest ciąg wysyłany przez serwer w ramach wyniku komunikatu.

Wywołaj ADsGetLastError w celu pobrania takich rozszerzonych komunikatów o błędach. Pierwszy parametr tej funkcji, lpError, jest wartością DWORD. W przypadku serwera usługi Active Directory interfejs ADSI próbuje zamapować komunikat o błędzie LDAP na odpowiedni kod błędu Win32 i przypisuje wartość kodu błędu Win32 do lpError. Nie można rozpoznać mapowania, interfejs ADSI przypisuje ERROR_INVALID_DATA do lpError, tak jak w przypadku dowolnego innego serwera katalogów. We wszystkich przypadkach usługa ADSI wiernie przekazuje ciąg opisu błędu z serwera do klienta za pośrednictwem lpErrorBuf, drugi parametr funkcji ADsGetLastError.