ADsSetLastError-Funktion (adshlp.h)

Artikel
02/26/2024

Der ADsSetLastError legt den Codewert des letzten Fehlers für den aufrufenden Thread fest. Verzeichnisdienstanbieter können diese Funktion verwenden, um erweiterte Fehler festzulegen. Die Funktion speichert die Fehlerdaten in einer Datenstruktur pro Thread. ADsSetLastError funktioniert ähnlich wie die SetLastError-Funktion .

Syntax

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

Parameter

[in] dwErr

Art: DWORD

Der aufgetretene Fehlercode. Wenn dies ein von Windows definierter Fehler ist, wird pszError ignoriert. Wenn dies ERROR_EXTENDED_ERROR ist, gibt dies an, dass der Anbieter einen netzwerkspezifischen Fehler zu melden hat.

[in] pszError

Typ: LPWSTR

Die mit Null beendete Unicode-Zeichenfolge, die den netzwerkspezifischen Fehler beschreibt.

[in] pszProvider

Typ: LPWSTR

Die mit NULL beendete Unicode-Zeichenfolge, die den ADSI-Anbieter benennt, der den Fehler ausgelöst hat.

Rückgabewert

Keine

Bemerkungen

In einer benutzerdefinierten Implementierung eines ADSI-Anbieters, z. B. einem LDAP-Anbieter, können Sie eine Vorgangsfehlermeldung wie folgt festlegen.

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

Der Benutzer kann das folgende Codebeispiel verwenden, um diesen Vorgangscode zu untersuchen.

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);
}

Im vorherigen Codebeispiel wird die folgende Ausgabe für den oben festgelegten Fehlercode für Vorgänge erzeugt.

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

Wenn Sie ERROR_DS_OPERATIONS_ERROR verwenden, ohne beim Festlegen des Fehlers das makro HRESULT_FROM_WIN32 aufrufen zu müssen, wird die folgende Ausgabe zurückgegeben.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	adshlp.h
Bibliothek	Activeds.lib
DLL	Activeds.dll

Weitere Informationen

Freigeben über