Freigeben über


IAzAuthorizationStore::AddPolicyReaderName-Methode (azroles.h)

Die AddPolicyReaderName-Methode fügt den angegebenen Kontonamen der Liste der Prinzipale hinzu, die als Richtlinienleser fungieren.

Syntax

HRESULT AddPolicyReaderName(
  [in]           BSTR    bstrReader,
  [in, optional] VARIANT varReserved
);

Parameter

[in] bstrReader

Kontoname, der der Liste der Richtlinienleser hinzugefügt werden soll. Der Kontoname muss im UpN-Format ( User Principal Name, Benutzerprinzipalname ) vorliegen (z. B. "someone@example.com"). Die LookupAccountName-Funktion wird aufgerufen, um die Domäne abzurufen.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Richtlinienleser für ein Objekt können Attribute für das Objekt und für untergeordnete Objekte des Objekts lesen. Leser können die Richtlinie auch nutzen; Beispielsweise können Leser die AccessCheck-Methode aufrufen. Leser können das Objekt oder seine untergeordneten Objekte nicht ändern.

Verwenden Sie die PolicyReadersName-Eigenschaft , um die Liste der Richtlinienleser im Kontonamenformat anzuzeigen.

Sie müssen die Submit-Methode aufrufen, um alle von dieser Methode vorgenommenen Änderungen beizubehalten.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile azroles.h
Bibliothek Azroles.lib
DLL Azroles.dll
Verteilbare Komponente Windows Server 2003 Administration Tools Pack unter Windows XP