IAzRole::AddPropertyItem-Methode (azroles.h)

  • Artikel

Die AddPropertyItem-Methode fügt die angegebene Entität der angegebenen Liste hinzu.

Syntax

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

Parameter

[in] lPropId

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

Wert Bedeutung
AZ_PROP_ROLE_APP_MEMBERS
 Kann auch mit der AddAppMember-Methode hinzugefügt werden
AZ_PROP_ROLE_MEMBERS
 Kann auch mit der AddMember-Methode hinzugefügt werden
AZ_PROP_ROLE_MEMBERS_NAME
 Kann auch mit der AddMemberName-Methode hinzugefügt werden
AZ_PROP_ROLE_OPERATIONS
 Kann auch mit der AddOperation-Methode hinzugefügt werden
AZ_PROP_ROLE_TASKS
 Kann auch mit der AddTask-Methode hinzugefügt werden

[in] varProp

Entität, die der durch den lPropId-Parameter angegebenen Liste hinzugefügt werden soll.

Die Variante muss eine BSTR-Variante sein.

Wenn AZ_PROP_ROLE_MEMBERS für den lPropId-Parameter angegeben wird, ist die Zeichenfolge die Textform des Sicherheitsbezeichners (SID) des Windows-Kontos, das der Liste hinzugefügt werden soll. Wenn AZ_PROP_ROLE_MEMBERS_NAME für den lPropId-Parameter angegeben wird, ist die Zeichenfolge der Kontoname des Kontos, das der Liste hinzugefügt werden soll. Der Kontoname kann entweder im UPN-Format (User Principal Name) (z. B. "someone@example.com") oder im Format "ExampleDomain\UserName" vorliegen. Wenn AZ_PROP_ROLE_APP_MEMBERS für den lPropId-Parameter angegeben wird, ist die Zeichenfolge die Name-Eigenschaft des IAzApplicationGroup-Objekts , das der Liste hinzugefügt werden soll.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Jeder andere 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