IAzApplication::D eletePropertyItem-Methode (azroles.h)

  • Artikel

Die DeletePropertyItem-Methode entfernt den angegebenen Prinzipal aus der angegebenen Liste von Prinzipalen.

Syntax

HRESULT DeletePropertyItem(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

Parameter

[in] lPropId

Eigenschafts-ID der Liste der Prinzipale, aus denen der durch den varProp-Parameter angegebene Prinzipal entfernt werden soll. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
AZ_PROP_POLICY_ADMINS
 Kann auch mithilfe der DeletePolicyAdministrator-Methode entfernt werden
AZ_PROP_POLICY_ADMINS_NAME
 Kann auch mithilfe der DeletePolicyAdministratorName-Methode entfernt werden
AZ_PROP_POLICY_READERS
 Kann auch mithilfe der DeletePolicyReader-Methode entfernt werden
AZ_PROP_POLICY_READERS_NAME
 Kann auch mithilfe der DeletePolicyReaderName-Methode entfernt werden
AZ_PROP_DELEGATED_POLICY_USERS
 Kann auch mithilfe der DeleteDelegatedPolicyUser-Methode entfernt werden
AZ_PROP_DELEGATED_POLICY_USERS_NAME
 Kann auch mithilfe der DeleteDelegatedPolicyUserName-Methode entfernt werden

[in] varProp

Prinzipal, der aus der Liste der Prinzipale entfernt werden soll, die durch den lPropId-Parameter angegeben werden.

Die Variante muss eine BSTR-Variante sein.

Wenn AZ_PROP_POLICY_ADMINS, AZ_PROP_POLICY_READERS oder AZ_PROP_DELEGATED_POLICY_USERS für den lPropId-Parameter angegeben ist, ist die Zeichenfolge die Textform der Sicherheits-ID (SID) des Windows-Kontos, das aus der Liste entfernt werden soll. Wenn AZ_PROP_POLICY_ADMINS_NAME, AZ_PROP_POLICY_READERS_NAME oder AZ_PROP_DELEGATED_POLICY_USERS_NAME für den lPropId-Parameter angegeben ist, ist die Zeichenfolge der Kontoname des Kontos, das aus der Liste entfernt werden soll. Der Kontoname kann entweder im UPN-Format (User Principal Name) (z. B. "someone@example.com") oder im Format "ExampleDomain\UserName" vorliegen.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

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

Jeder andere HRESULT-Wert gibt an, dass der Vorgang fehlgeschlagen ist.

Hinweise

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

Anforderungen

Anforderung Wert
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