次の方法で共有


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