LsaGetAppliedCAPIDs-Funktion (ntlsa.h)

Die LsaGetAppliedCAPIDs-Funktion gibt ein Array von CAPIDs (Central Access Policies) aller auf einen bestimmten Computer angewendeten CAPs zurück.

Syntax

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

Parameter

[in, optional] SystemName

Ein Zeiger auf eine LSA_UNICODE_STRING-Struktur , die den Namen des jeweiligen Computers enthält. Der Name kann die Form "ComputerName" oder "\ComputerName" haben. Wenn dieser Parameter NULL ist, gibt die Funktion die CAPIDs des lokalen Computers zurück.

[out] CAPIDs

Ein Zeiger auf eine Variable, die ein Array von Zeigern auf CAPIDs empfängt, die die auf dem angegebenen Computer verfügbaren CAPs identifizieren. Wenn Sie die CAPIDs verwendet haben, rufen Sie die LsaFreeMemory-Funktion für jedes Element im Array und das gesamte Array auf.

[out] CAPIDCount

Ein Zeiger auf eine Variable, die die Anzahl der auf dem angegebenen Computer verfügbaren CAPs empfängt. Das im CAPIDs-Parameter zurückgegebene Array enthält die gleiche Anzahl von Elementen wie der CAPIDCount-Parameter .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Rückgabewerte der LSA-Richtlinienfunktion. Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Hinweise

Für spezifische Details zu den zentralen Zugriffsrichtlinien können Sie die Attribute des zentralen Zugriffsrichtlinienobjekts im Active Directory auf dem Domänencontroller des angegebenen Computers abfragen. Suchen Sie nach dem Objekt, dessen Attribut msAuthz-CentralAccessPolicyID mit einem der zurückgegebenen CAPIDs übereinstimmt.

Anforderungen

Weitere Informationen

Zentralisierte Autorisierungsrichtlinie