1 out of 2 rated this helpful - Rate this topic

BackupEventlog method of the Win32_NTEventlogFile Class

Applies to: desktop apps only

The BackupEventLog method saves the specified event log to a backup file. If a backup file with the same name exists, the method fails.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

uint32 BackupEventlog(
  [in]  string ArchiveFileName
);

Parameters

ArchiveFileName [in]

Path and file name of the backup file to be created.

Note   If the ArchiveFileName comes from a source that you do not know or trust, then this parameter value should be verified before using it in a call to BackupEventlog.

Return value

Return codeDescription
0

Success

8

Privilege missing

21

Invalid parameter

80

Archive file name already exists. This value is returned starting with Windows Vista.

Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0:  The return code indicating that the archive file name already exists is 183.

 

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Namespace

\root\CIMV2

MOF

Ntevt.mof

DLL

Ntevt.dll

See also

Operating System Classes
Win32_NTEventlogFile

 

 

Send comments about this topic to Microsoft

Build date: 3/9/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Required privilege
To invoke this method, SE_BACKUP_NAME privilege must be enabled.
戻り値
処理に失敗したとき、上記以外の戻り値を返すことがあります。
その場合、Windowsが定義するエラーコードを確認するため、エラールックアップなどのツールを使って確認することをお薦めします。