LookupAccountSidLocalA-Funktion (winbase.h)
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) |