AuthzInitializeObjectAccessAuditEvent2 関数 (authz.h)

AuthzInitializeObjectAccessAuditEvent2 関数は、AuthzAccessCheck 関数で使用するAUTHZ_AUDIT_EVENT_HANDLE ハンドルを割り当てて初期化します。

構文

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent2(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [in]  PWSTR                         szAdditionalInfo2,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

パラメーター

[in] Flags

監査の動作を変更するフラグ。 次の表に、それぞれの値を示します。

[値]	意味
AUTHZ_NO_ALLOC_STRINGS	メモリを割り当て、文字列をコピーする代わりに、渡された文字列へのポインターを使用します。 呼び出し元のアプリケーションは、アクセス チェック中に渡されたメモリが有効なままであることを確認する必要があります。
AUTHZ_NO_FAILURE_AUDIT	エラー監査の生成を無効にします。
AUTHZ_NO_SUCCESS_AUDIT	成功監査の生成を無効にします。

[in] hAuditEventType

予約済み。 このパラメーターは NULL に設定する必要があります。

[in] szOperationType

監査する操作を示す文字列へのポインター。

[in] szObjectType

アクセスされるオブジェクトの種類を示す文字列へのポインター。

[in] szObjectName

アクセスされるオブジェクトの名前を示す文字列へのポインター。

[in] szAdditionalInfo

追加の監査情報を含むResource Managerによって定義された文字列へのポインター。

[in] szAdditionalInfo2

追加の監査情報を含むResource Managerによって定義された文字列へのポインター。

[out] phAuditEvent

返された AUTHZ_AUDIT_EVENT_HANDLE ハンドルへのポインター。

[in] dwAdditionalParameterCount

0 に設定する必要があります。

...

追加のパラメーター。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗した場合は、 FALSE を返します。 拡張エラー情報については、 GetLastError を呼び出します。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	authz.h
Library	Authz.lib
[DLL]	Authz.dll
再頒布可能パッケージ	Windows XP の Windows Server 2003 管理ツール パック

こちらもご覧ください

AuthzAccessCheck

基本的なAccess Control関数