BuildTrusteeWithSidA-Funktion (aclapi.h)
Die BuildTrusteeWithSid-Funktion initialisiert eine TRUSTEE-Struktur . Der Aufrufer gibt den Sicherheitsbezeichner (SID) des Treuhänders an. Die Funktion legt andere Elemente der Struktur auf Standardwerte fest und sucht nicht nach dem namen, der der SID zugeordnet ist.
Syntax
void BuildTrusteeWithSidA(
[in, out] PTRUSTEE_A pTrustee,
[in, optional] PSID pSid
);
Parameter
[in, out] pTrustee
Ein Zeiger auf eine zu initialisierende TRUSTEE-Struktur . Die BuildTrusteeWithSid-Funktion weist keinen Arbeitsspeicher zu. Wenn dieser Parameter NULL oder ein ungültiger Zeiger ist, sind die Ergebnisse nicht definiert.
[in, optional] pSid
Ein Zeiger auf eine SID-Struktur , die den Treuhänder identifiziert. Die BuildTrusteeWithSid-Funktion weist diesen Zeiger dem ptstrName-Member der TRUSTEE-Struktur zu. Die Funktion legt die anderen Elemente der TRUSTEE-Struktur wie folgt fest.
Wert | Bedeutung |
---|---|
|
NULL |
|
NO_MULTIPLE_TRUSTEE |
|
TRUSTEE_IS_SID |
|
TRUSTEE_IS_UNKNOWN |
Rückgabewert
Keine
Bemerkungen
Hinweis
Der aclapi.h-Header definiert BuildTrusteWithSid 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 | aclapi.h |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |
Weitere Informationen
Grundlegende Access Control-Funktionen