Partilhar via


Mensagens de erro estendidas ADSI

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

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 desta função, lpError, é um valor DWORD. Para um servidor do Ative 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, ADSI atribui ERROR_INVALID_DATA para lpError, como faz para qualquer outro servidor de diretório. Em todos os casos, ADSI retransmite fielmente a cadeia de caracteres da descrição do erro do servidor para o cliente através lpErrorBuf, o segundo parâmetro da função ADsGetLastError.