Método IAzRole::AddPropertyItem (azroles.h)

O método AddPropertyItem adiciona a entidade especificada à lista especificada.

Sintaxe

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

Parâmetros

[in] lPropId

ID da propriedade da lista à qual adicionar a entidade especificada pelo parâmetro varProp . A tabela a seguir mostra os valores possíveis.

Valor	Significado
AZ_PROP_ROLE_APP_MEMBERS	Também pode ser adicionado usando o método AddAppMember
AZ_PROP_ROLE_MEMBERS	Também pode ser adicionado usando o método AddMember
AZ_PROP_ROLE_MEMBERS_NAME	Também pode ser adicionado usando o método AddMemberName
AZ_PROP_ROLE_OPERATIONS	Também pode ser adicionado usando o método AddOperation
AZ_PROP_ROLE_TASKS	Também pode ser adicionado usando o método AddTask

[in] varProp

Entidade a ser adicionada à lista especificada pelo parâmetro lPropId .

A variante deve ser uma variante BSTR .

Se AZ_PROP_ROLE_MEMBERS for especificado para o parâmetro lPropId , a cadeia de caracteres será a forma de texto do SID ( identificador de segurança ) da conta do Windows a ser adicionada à lista. Se AZ_PROP_ROLE_MEMBERS_NAME for especificado para o parâmetro lPropId , a cadeia de caracteres será o nome da conta a ser adicionada à lista. O nome da conta pode estar no formato UPN (nome upn) (por exemplo, "someone@example.com") ou no formato "ExampleDomain\UserName". Se AZ_PROP_ROLE_APP_MEMBERS for especificado para o parâmetro lPropId , a cadeia de caracteres será a propriedade Name do objeto IAzApplicationGroup a ser adicionado à lista.

[in, optional] varReserved

Reservado para uso futuro.

Retornar valor

O valor retornado é um HRESULT. Um valor de S_OK indica êxito. Qualquer outro valor indica que a operação falhou.

Comentários

Você deve chamar o método Submit para persistir as alterações feitas por esse método.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	azroles.h
Biblioteca	Azroles.lib
DLL	Azroles.dll
Redistribuível	Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP