LsaSetInformationPolicy 関数 (ntsecapi.h)

LsaSetInformationPolicy 関数は、Policy オブジェクトの情報を変更します。

構文

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

パラメーター

[in] PolicyHandle

Policy オブジェクトへのハンドル。このハンドルに必要なアクセス権は 、InformationClass パラメーターの値によって異なります。詳細については、「ポリシーオブジェクトハンドルを開く」を参照してください。

[in] InformationClass

POLICY_INFORMATION_CLASS列挙型から次のいずれかの値を指定します。値は、設定する情報の種類を示します。

値	意味
PolicyAuditEventsInformation	システムの監査規則を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_SET_AUDIT_REQUIREMENTSアクセス権が必要です。 Buffer パラメーターは、POLICY_AUDIT_EVENTS_INFO構造体へのポインターである必要があります。
PolicyPrimaryDomainInformation	システムのプライマリドメインの名前と SID を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_PRIMARY_DOMAIN_INFO構造体へのポインターである必要があります。
PolicyAccountDomainInformation	システムのアカウントドメインの名前と SID を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_ACCOUNT_DOMAIN_INFO構造体へのポインターである必要があります。
PolicyDnsDomainInformation	Policy オブジェクトに関連付けられているプライマリドメインに関するドメインネームシステム (DNS) 情報を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_DNS_DOMAIN_INFO構造体へのポインターである必要があります。
PolicyLsaServerRoleInformation	LSA サーバーの役割を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_SERVER_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_LSA_SERVER_ROLE_INFO構造体へのポインターである必要があります。サーバーの役割をプライマリからバックアップに変更しても影響はありません (ただし、関数はSTATUS_SUCCESSを返します)。サーバーの役割をバックアップからプライマリに変更するには、広範なネットワーク操作が必要であり、速度が低下する可能性があります。

[in] Buffer

設定する情報を含む構造体へのポインター。構造体の種類は 、InformationClass パラメーターの値によって異なります。

戻り値

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は NTSTATUS コードです。詳細については、「 LSA ポリシー関数の戻り値」を参照してください。

LsaNtStatusToWinError 関数を使用して、NTSTATUS コードを Windows エラーコードに変換できます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	ntsecapi.h
Library	Advapi32.lib
[DLL]	Advapi32.dll