IAzScope::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

[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 oder AZ_PROP_POLICY_READERS 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 oder AZ_PROP_POLICY_READERS_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,someone@example.com Benutzerprinzipalname) oder im Format "ExampleDomain\UserName" vorliegen.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt den Erfolg an. Jeder andere Wert gibt an, dass der Vorgang fehlgeschlagen ist.

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