LookupAccountSidLocalA-Funktion (winbase.h)

Artikel
03/08/2023

LookupAccountSidLocalA ist als Makro definiert, das LookupAccountSidA mit NULL als ersten Parameter aufruft. Ruft den Namen des Kontos für die angegebene SID auf dem lokalen Computer ab.

Syntax

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

Parameter

[in] Sid

Ein Zeiger auf die SID , um nachzuschlagen.

[out, optional] Name

Ein Zeiger auf einen Puffer, der eine null-beendete Zeichenfolge empfängt, die den Kontonamen enthält, der dem lpSid-Parameter entspricht.

[in, out] cchName

Gibt bei der Eingabe die Größe des lpName-Puffers in TCHARs an. Wenn die Funktion fehlschlägt, weil der Puffer zu klein ist oder cchName null ist, empfängt cchName die erforderliche Puffergröße, einschließlich des beendenden NULL-Zeichens .

[out, optional] ReferencedDomainName

Ein Zeiger auf einen Puffer, der eine NULL-Zeichenfolge empfängt, die den Namen der Domäne enthält, in der der Kontoname gefunden wurde.

Auf einem Server ist der Domänenname, der für die meisten Konten in der Sicherheitsdatenbank des lokalen Computers zurückgegeben wird, der Name der Domäne, für die der Server ein Domänencontroller ist.

Auf einer Arbeitsstation ist der Domänenname, der für die meisten Konten in der Sicherheitsdatenbank des lokalen Computers zurückgegeben wird, der Name des Computers zum letzten Start des Systems (umgekehrte Schrägstriche sind ausgeschlossen). Wenn sich der Name des Computers ändert, wird der alte Name weiterhin als Domänenname zurückgegeben, bis das System neu gestartet wird.

Einige Konten sind vom System vordefiniert. Der für diese Konten zurückgegebene Domänenname ist BUILTIN.

[in, out] cchReferencedDomainName

Gibt bei der Eingabe die Größe des Puffers lpReferencedDomainName in TCHARs an. Wenn die Funktion fehlschlägt, weil der Puffer zu klein ist oder cchReferencedDomainName null ist, empfängt cchReferencedDomainName die erforderliche Puffergröße, einschließlich des beendenden NULL-Zeichens .

[out] peUse

Ein Zeiger auf eine Variable, die einen SID_NAME_USE Wert empfängt, der den Typ des Kontos angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion ähnelt LookupAccountSid, schränkt die Suche jedoch auf den lokalen Computer ein.

Hinweis

Der winbase.h-Header definiert LookupAccountSidLocal als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)