IAzApplication::AddPropertyItem-Methode (azroles.h)

  • Artikel

Die AddPropertyItem-Methode fügt den angegebenen Prinzipal der angegebenen Liste der Prinzipale hinzu.

Syntax

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

Parameter

[in] lPropId

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

Wert Bedeutung
AZ_PROP_POLICY_ADMINS
 Kann auch mit der AddPolicyAdministrator-Methode hinzugefügt werden
AZ_PROP_POLICY_ADMINS_NAME
 Kann auch mit der AddPolicyAdministratorName-Methode hinzugefügt werden
AZ_PROP_POLICY_READERS
 Kann auch mit der AddPolicyReader-Methode hinzugefügt werden
AZ_PROP_POLICY_READERS_NAME
 Kann auch mit der AddPolicyReaderName-Methode hinzugefügt werden
AZ_PROP_DELEGATED_POLICY_USERS
 Kann auch mit der AddDelegatedPolicyUser-Methode hinzugefügt werden
AZ_PROP_DELEGATED_POLICY_USERS_NAME
 Kann auch mit der AddDelegatedPolicyUserName-Methode hinzugefügt werden

[in] varProp

Prinzipal, der der Liste der Prinzipale hinzugefügt werden soll, die durch den lPropId-Parameter angegeben werden.

Die Variante muss eine BSTR-Variante sein.

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 der Liste hinzugefügt werden soll. Der Kontoname muss im UPN-Format (User Principal Name) vorliegen (z. B. "someone@example.com").

[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 beim Vorgang ein Fehler aufgetreten 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