Поделиться через

Метод IAzObjectPicker::GetPrincipals (azroles.h)

  • Статья

Метод GetPrincipals отображает диалоговое окно, в котором пользователи могут выбрать один или несколько субъектов, а затем возвращает выбранный список субъектов и соответствующие им идентификаторы безопасности (SID).

Синтаксис

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

Параметры

[in] hParentWnd

Дескриптор родительского окна диалогового окна.

[in] bstrTitle

Отображаемый заголовок диалогового окна.

[out] pvSidTypes

Указатель на массив элементов перечисления SID_NAME_USE , указывающих типы идентификаторов безопасности, соответствующие субъектам, выбранным пользователем.

Это вариант, содержащий объект SAFEARRAY или массив JScript. Каждый элемент массива содержит VT_I4 значение, указывающее элемент перечисления SID_NAME_USE .

[out] pvNames

Указатель на массив отображаемых имен субъектов, выбранных пользователем.

Это вариант, содержащий объект SAFEARRAY или массив JScript. Каждый элемент массива содержит VT_BSTR , содержащий отображаемое имя.

[out] pvSids

Указатель на массив строковых представлений идентификаторов безопасности, соответствующих субъектам, выбранным пользователем.

Это вариант, содержащий объект SAFEARRAY или массив JScript. Каждый элемент массива содержит VT_BSTR , содержащий строковое представление идентификатора безопасности.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK.

Если происходит сбой метода, он возвращает код ошибки. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header azroles.h