Mensagens de erro estendidas do ADSI

Além dos valores HRESULT , vários provedores de sistema ADSI (principalmente LDAP) retornam dados de erro adicionais para operações executadas pelas seguintes interfaces:

• DAIs
• IADsContainer
• IDirectoryObject
• IDirectorySearch

Uma parte desses dados de erro estendidos é a cadeia de caracteres enviada pelo servidor como parte do resultado da mensagem.

Chame ADsGetLastError para recuperar essas mensagens de erro estendidas. O primeiro parâmetro dessa função, lpError, é um valor DWORD. Para um servidor do Active Directory, o ADSI tenta mapear uma mensagem de erro LDAP para um código de erro Win32 apropriado e atribui o valor do código de erro Win32 a lpError. Falhando ao resolver o mapeamento, o ADSI atribui ERROR_INVALID_DATA a lpError, como faz para qualquer outro servidor de diretório. Em todos os casos, o ADSI retransmite fielmente a cadeia de caracteres da descrição do erro do servidor para o cliente por meio de lpErrorBuf, o segundo parâmetro da função ADsGetLastError .