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 유형을 지정하는 SID_NAME_USE 열거형 요소 배열에 대한 포인터입니다.

SAFEARRAY 또는 JScript Array 개체를 포함하는 변형입니다. 배열의 각 요소는 SID_NAME_USE 열거형의 요소를 지정하는 VT_I4 값을 보유합니다.

[out] pvNames

사용자가 선택한 보안 주체의 표시 이름 배열에 대한 포인터입니다.

SAFEARRAY 또는 JScript Array 개체를 포함하는 변형입니다. 배열의 각 요소는 표시 이름을 포함하는 VT_BSTR 보유합니다.

[out] pvSids

사용자가 선택한 보안 주체에 해당하는 SID의 문자열 표현 배열에 대한 포인터입니다.

SAFEARRAY 또는 JScript Array 개체를 포함하는 변형입니다. 배열의 각 요소는 SID의 문자열 표현을 포함하는 VT_BSTR 보유합니다.

반환 값

메서드가 성공하면 S_OK 반환합니다.

메서드가 실패하면 오류 코드가 반환됩니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	azroles.h