IAzRole::AddPropertyItem-Methode (azroles.h)

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.

[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