Método IAzObjectPicker::GetPrincipals (azroles.h)

O método GetPrincipals exibe uma caixa de diálogo da qual os usuários podem escolher uma ou mais entidades de segurança e retorna a lista escolhida de entidades de segurança e seus SIDs ( identificadores de segurança ) correspondentes.

Sintaxe

HRESULT GetPrincipals(
  [in]  HWND    hParentWnd,
  [in]  BSTR    bstrTitle,
  [out] VARIANT *pvSidTypes,
  [out] VARIANT *pvNames,
  [out] VARIANT *pvSids
);

Parâmetros

[in] hParentWnd

Um identificador para a janela pai da caixa de diálogo.

[in] bstrTitle

O título de exibição da caixa de diálogo.

[out] pvSidTypes

Um ponteiro para uma matriz de elementos do SID_NAME_USE enumeração que especifica os tipos dos SIDs que correspondem às entidades de segurança escolhidas pelo usuário.

Essa é uma variante que contém uma SAFEARRAY ou o objeto JScript Array . Cada elemento da matriz contém um valor VT_I4 que especifica um elemento da enumeração SID_NAME_USE .

[out] pvNames

Um ponteiro para uma matriz de nomes de exibição das entidades de segurança escolhidas pelo usuário.

Essa é uma variante que contém uma SAFEARRAY ou o objeto JScript Array . Cada elemento da matriz contém um VT_BSTR que contém um nome de exibição.

[out] pvSids

Um ponteiro para uma matriz de representações de cadeia de caracteres dos SIDs que correspondem às entidades de segurança escolhidas pelo usuário.

Essa é uma variante que contém uma SAFEARRAY ou o objeto JScript Array . Cada elemento da matriz contém um VT_BSTR que contém uma representação de cadeia de caracteres de um SID.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um código de erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Requisitos