AuditLogLocation Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the location where security-related event logs are written.

Namespace:   System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

type AuditLogLocation

Member nameDescription
Application

Specifies the Application log in the event log.

Default

Specifies the default location, which is determined by the operating system. If writing to the Security log is supported (such as on Windows Vista and Windows Server 2003 and later platforms), the default log location is the Security log. Otherwise (such as in Windows XP SP2), the default log location is the Application log.

Security

Specifies the Security log in the event log. The calling thread must have SeAuditPrivilege to be able to write to the Security log.

When creating a Windows Communication Foundation (WCF) application that requires authentication and/or authorization of callers, you can specify that events related to security be recorded for either success, failure, or both. The location of the log is determined by this enumeration.

The level of the audit log is specified by setting the MessageAuthenticationAuditLevel or the ServiceAuthorizationAuditLevel property of the ServiceSecurityAuditBehavior class to one of the AuditLevel values.

You can also specify audit behavior using the <serviceSecurityAudit> binding.

System_CAPS_importantImportant

If the AuditLogLocation property is set to Security and Audit Object Access is not set in the Local Security Policy, audit events will not be written to the Security log. No failure is returned, but audit entries will not be written to the Security log. In addition, the calling thread must have SeAuditPrivilege to be able to write to the Security log.

When setting the property to the Default value, the operating system determines which log will actually be written to. For more information, see Auditing Security Events.

The following example sets the AuditLogLocation property to one of the AuditLogLocation values.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.0
Return to top
Show: