AUTHZ_SOURCE_SCHEMA_REGISTRATION structure (authz.h)

The AUTHZ_SOURCE_SCHEMA_REGISTRATION structure specifies information about source schema registration.

Syntax

typedef struct _AUTHZ_SOURCE_SCHEMA_REGISTRATION {
  DWORD                                      dwFlags;
  PWSTR                                      szEventSourceName;
  PWSTR                                      szEventMessageFile;
  PWSTR                                      szEventSourceXmlSchemaFile;
  PWSTR                                      szEventAccessStringsFile;
  PWSTR                                      szExecutableImagePath;
  union {
    PVOID pReserved;
    GUID  *pProviderGuid;
  } DUMMYUNIONNAME;
  DWORD                                      dwObjectTypeNameCount;
  AUTHZ_REGISTRATION_OBJECT_TYPE_NAME_OFFSET ObjectTypeNames[ANYSIZE_ARRAY];
} AUTHZ_SOURCE_SCHEMA_REGISTRATION, *PAUTHZ_SOURCE_SCHEMA_REGISTRATION;

Members

dwFlags

Flags that control the behavior of the operation. The following table shows a possible value.

Value Meaning
AUTHZ_ALLOW_MULTIPLE_SOURCE_INSTANCES
0x1
Allows registration of multiple sources with the same name. Use of this flag means that more than one source can call the AuthzRegisterSecurityEventSource function with the same szEventSourceName at runtime.
AUTHZ_MIGRATED_LEGACY_PUBLISHER
0x2
The caller is a migrated publisher that has registered a manifest with WEvtUtil.exe. The GUID of the provider specified by the pProviderGuid member is stored in the registry.

szEventSourceName

A pointer to a wide character string that represents the name of the event source.

szEventMessageFile

A pointer to a wide character string that represents the name of the resource that contains the event messages.

szEventSourceXmlSchemaFile

A pointer to a wide character string that represents the name of the XML schema file for the event source.

szEventAccessStringsFile

A pointer to a wide character string that represents the name of the resource that contains the event parameter strings.

szExecutableImagePath

This member is reserved and must be set to NULL.

DUMMYUNIONNAME

DUMMYUNIONNAME.pReserved

This member is reserved and must be set to NULL.

DUMMYUNIONNAME.pProviderGuid

The GUID of a migrated publisher. The value of this member is converted to a string and stored in the registry if the caller is a migrated publisher.

dwObjectTypeNameCount

The number of objects in the ObjectTypeNames array.

ObjectTypeNames[ANYSIZE_ARRAY]

An array of AUTHZ_REGISTRATION_OBJECT_TYPE_NAME_OFFSET structures that represents the object types for the events.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Header authz.h
Redistributable Windows Server 2003 Administration Tools Pack on Windows XP

See also

AuthzEnumerateSecurityEventSources

AuthzInstallSecurityEventSource