IAzAuthorizationStore::Initialize メソッド (azroles.h)

Initialize メソッドは、承認マネージャーを初期化します。

構文

HRESULT Initialize(
  [in]           LONG    lFlags,
  [in]           BSTR    bstrPolicyURL,
  [in, optional] VARIANT varReserved
);

パラメーター

[in] lFlags

初期化の動作を制御するフラグ。 このパラメーターには、次の値のいずれかを指定できます。

AZ_AZSTORE_FLAG_CREATE フラグが指定されている場合:

• システムは、 bstrPolicyURL パラメーターで指定された基になるポリシー ストアの作成を試みます。
• 指定したポリシー ストアが存在する場合、 Initialize メソッドはERROR_ALREADY_EXISTSで失敗します。
• このメソッドによって行われた変更を保持するには、 Submit メソッドを呼び出す必要があります。
• UpdateCache メソッドは、Submit メソッドが呼び出されるまで失敗します。 基になるポリシー ストアは、 Submit が呼び出されたときに実際に作成されます。

[in] bstrPolicyURL

承認ポリシー データベースの永続的なコピーの場所。

この文字列には、ポリシー URL プレフィックスとプロバイダー固有のポリシーの場所の両方が含まれている必要があります。 承認マネージャーは、プロバイダー プレフィックスを使用して適切なプロバイダーを読み込みます。 ストアは、プロバイダー固有のポリシーの場所から読み込まれます。 ポリシー URL プレフィックスにスペースは使用できません。

Active Directory ストアのポリシー URL プレフィックスは msldap: です。 URL の一般的な形式は次のとおりです。

msldap://ServerName:Port//DistinguishedNameForTheStore

サーバー名とポートは省略可能です。 サーバー名が指定されていない場合は、既定のドメイン コントローラーが使用されます。 ポートが指定されていない場合は、既定の LDAP ポート (LDAP_PORT、389) が使用されます。 ストアの識別名 (DN) は、 AzAuthorizationStore オブジェクトの相対識別名 (RDN) で始まります。 たとえば、 AzAuthorizationStore オブジェクトの RDN が MyStore で、MyStore が AzMan という名前の組織単位 (OU) にある場合、Active Directory ストアの URL は次のようになります。

msldap:// MyServer/CN=MyStore,OU=AzMan,DC=MyDomain,DC=Fabrikam,DC=Com

XML ストアのポリシー URL プレフィックスは msxml: です。 XML ストア URL の一般的な形式は、次の例に示すように、ファイル URL の場合と同じです。

• msxml://c:/abc/test.xml
• msxml://\\server\share\abc.xml
• msxml://d|/dir1/dir2/abc.xml
• msxml://c:/Documents%20and%20Settings/test%2exml

[in, optional] varReserved

将来利用するために予約されています。 このパラメーターには、次のいずれかの値を指定できます。

• varReserved.vt == VT_ERROR と varReserved.scode == DISP_E_PARAMNOTFOUND
• varReserved.vt == VT_EMPTY
• varReserved.vt == VT_NULL
• varReserved.vt == VT_I4 および varReserved.lVal == 0
• varReserved.vt == VT_I2 および varReserved.iVal == 0

戻り値

メソッドが成功した場合、メソッドは S_OKを返します。

bstrPolicyURL パラメーターが無効な場合、メソッドは HRESULT_FROM_WIN32(ERROR_INVALID_NAME) を返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

Active Directory では、ドメイン以外の名前付けコンテキストとも呼ばれるアプリケーション パーティションがサポートされています。 これらのパーティションは、アプリケーション データを格納するプログラムの場所として使用されます。 承認マネージャー ポリシー ストアを作成したり、アプリケーション パーティションに保持したりすることはできません。代わりに、Program Data コンテナーを Active Directory Authorization Manager ポリシー ストアのコンテナーとして使用します。

要件