/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/*
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "NPL"); you may not use this file except in
 * compliance with the NPL.  You may obtain a copy of the NPL at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the NPL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
 * for the specific language governing rights and limitations under the
 * NPL.
 *
 * The Initial Developer of this code under the NPL is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1999 Netscape Communications Corporation.  All Rights
 * Reserved.
 */
/*used to pass principals through xpcom in arrays*/
#include "nsISupports.idl"
#include "nsIPrincipal.idl"

[uuid(f118c9cc-452c-11d3-ba17-0060b0f199a2)]
interface nsIPrincipalArray : nsISupports
{
	const short SetComparisonType_ProperSubset = -1;
	const short SetComparisonType_Equal = 0;
	const short SetComparisonType_NoSubset = 1;

	void ComparePrincipalArray(in nsIPrincipalArray other, out short comparisonType);

	void IntersectPrincipalArray(in nsIPrincipalArray other, out nsIPrincipalArray result);

	void FreePrincipalArray();

	void AddPrincipalArrayElement(in nsIPrincipal principal);

	void GetPrincipalArrayElement(in unsigned long index, out nsIPrincipal result);

	void SetPrincipalArrayElement(in unsigned long index, in nsIPrincipal principal);

	void GetPrincipalArraySize(out unsigned long result);
};