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列挙型から次のいずれかの値を指定します。 値は、設定する情報の種類を示します。
| 値 | 意味 |
|---|---|
|
システムの監査規則を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_SET_AUDIT_REQUIREMENTSアクセス権が必要です。 Buffer パラメーターは、POLICY_AUDIT_EVENTS_INFO構造体へのポインターである必要があります。 |
|
システムのプライマリ ドメインの名前と SID を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_PRIMARY_DOMAIN_INFO構造体へのポインターである必要があります。 |
|
システムのアカウント ドメインの名前と SID を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_ACCOUNT_DOMAIN_INFO構造体へのポインターである必要があります。 |
|
Policy オブジェクトに関連付けられているプライマリ ドメインに関するドメイン ネーム システム (DNS) 情報を設定します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_TRUST_ADMINアクセス権が必要です。 Buffer パラメーターは、POLICY_DNS_DOMAIN_INFO構造体へのポインターである必要があります。 |
|
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 |