Compartir a través de

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

  • Artículo

El método GetPrincipals muestra un cuadro de diálogo del que los usuarios pueden elegir una o varias entidades de seguridad y, a continuación, devuelve la lista elegida de entidades de seguridad y sus identificadores de seguridad correspondientes (SID).

Sintaxis

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

Parámetros

[in] hParentWnd

Identificador de la ventana primaria del cuadro de diálogo.

[in] bstrTitle

Título para mostrar del cuadro de diálogo.

[out] pvSidTypes

Puntero a una matriz de elementos de la enumeración SID_NAME_USE que especifica los tipos de los SID que corresponden a las entidades de seguridad elegidas por el usuario.

Se trata de una variante que contiene un SAFEARRAY o el objeto Array de JScript. Cada elemento de la matriz contiene un valor de VT_I4 que especifica un elemento de la enumeración SID_NAME_USE .

[out] pvNames

Puntero a una matriz de nombres para mostrar de las entidades de seguridad elegidas por el usuario.

Se trata de una variante que contiene un SAFEARRAY o el objeto Array de JScript. Cada elemento de la matriz contiene un VT_BSTR que contiene un nombre para mostrar.

[out] pvSids

Puntero a una matriz de representaciones de cadena de los SID que corresponden a las entidades de seguridad elegidas por el usuario.

Se trata de una variante que contiene un SAFEARRAY o el objeto Array de JScript. Cada elemento de la matriz contiene un VT_BSTR que contiene una representación de cadena de un SID.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Si el método genera un error, este método devuelve un código de error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado azroles.h