LsaQueryInformationPolicy 関数 (ntsecapi.h)

  • [アーティクル]

LsaQueryInformationPolicy 関数は、Policy オブジェクトに関する情報を取得します。

構文

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

パラメーター

[in] PolicyHandle

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

[in] InformationClass

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

値 意味
PolicyAuditEventsInformation
 システムの監査規則を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_AUDIT_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_AUDIT_EVENTS_INFO構造体へのポインターを受け取ります。
PolicyPrimaryDomainInformation
 システムのプライマリ ドメインの名前と SID を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_PRIMARY_DOMAIN_INFO構造体へのポインターを受け取ります。
PolicyAccountDomainInformation
 システムのアカウント ドメインの名前と SID を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_ACCOUNT_DOMAIN_INFO構造体へのポインターを受け取ります。
PolicyLsaServerRoleInformation
 LSA サーバーの役割を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_LSA_SERVER_ROLE_INFO構造体へのポインターを受け取ります。
PolicyModificationInformation
 LSA データベースの作成時刻と最終変更に関する情報を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_MODIFICATION_INFO構造体へのポインターを受け取ります。
PolicyDnsDomainInformation
 Policy オブジェクトに関連付けられているプライマリ ドメインに関するドメイン ネーム システム (DNS) 情報を取得します。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 Buffer パラメーターは、POLICY_DNS_DOMAIN_INFO構造体へのポインターを受け取ります。

[out] Buffer

要求された情報を含む構造体へのポインターを受け取る変数へのポインター。 構造体の種類は 、InformationClass パラメーターの値によって異なります。

情報が不要になったら、返されたポインターを LsaFreeMemory に渡します。

戻り値

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

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

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

注釈

この関数の呼び出しを示す例については、「 ポリシー情報の管理」を参照してください。

要件

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

こちらもご覧ください

LsaFreeMemory

LsaSetInformationPolicy

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_INFORMATION_CLASS

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO