objidlib.cpp File Reference

A library for working with NTFS Object Idenitifers. More...

#include "stdafx.h"
#include "objidlib.h"

Functions
OBJIDLIB_API BOOL	ObjectIdExists (IN LPCWSTR sFileName)
	Checks an existence of an object id of a specified file.
OBJIDLIB_API BOOL	CreateObjectId (IN LPCWSTR sFileName, OUT POBJECTID_ATTRIBUTE pObjId)
	Request a system to create a new object id in a specified file.
OBJIDLIB_API BOOL	GetObjectId (IN LPCWSTR sFileName, OUT POBJECTID_ATTRIBUTE pObjId)
	Get a contents of an object id of a specified file.
OBJIDLIB_API BOOL	DeleteObjectId (IN LPCWSTR sFileName)
	Delete an object id of a specified file.
OBJIDLIB_API BOOL	SetObjectId (IN LPCWSTR sFileName, IN POBJECTID_ATTRIBUTE pObjId)
	Set an object id of a specified file. SE_RESTORE_PRIVILEGE required.
OBJIDLIB_API BOOL	SetObjectIdExt (IN LPCWSTR sFileName, IN POBJECTID_ATTRIBUTE pObjId)
	Set an extended part of an object id of a specified file.

---

Detailed Description

A library for working with NTFS Object Idenitifers.

Author:

amdf

Version:

0.2

Date:

September 2011

---

Function Documentation

OBJIDLIB_API BOOL CreateObjectId	(	IN LPCWSTR	sFileName,
		OUT POBJECTID_ATTRIBUTE	pObjId
	)

Request a system to create a new object id in a specified file.

Parameters:

[in]	sFileName	File name
[out]	pObjId	Pointer to a buffer receiving a content of a new object id. If this parameter is NULL, it is ignored.

Returns:

TRUE if success, FALSE otherwise

OBJIDLIB_API BOOL DeleteObjectId

(

IN LPCWSTR

sFileName

)

Delete an object id of a specified file.

Parameters:

[in]

sFileName

File name

Returns:

TRUE if success, FALSE otherwise

OBJIDLIB_API BOOL GetObjectId	(	IN LPCWSTR	sFileName,
		OUT POBJECTID_ATTRIBUTE	pObjId
	)

Get a contents of an object id of a specified file.

Parameters:

[in]	sFileName	File name
[out]	pObjId	Pointer to a buffer receiving a content of a new object id. If this parameter is NULL, it is ignored.

Returns:

TRUE if success, FALSE otherwise

OBJIDLIB_API BOOL ObjectIdExists

(

IN LPCWSTR

sFileName

)

Checks an existence of an object id of a specified file.

Parameters:

[in]

sFileName

File name

Returns:

TRUE if exists, FALSE otherwise

OBJIDLIB_API BOOL SetObjectId	(	IN LPCWSTR	sFileName,
		IN POBJECTID_ATTRIBUTE	pObjId
	)

Set an object id of a specified file. SE_RESTORE_PRIVILEGE required.

Parameters:

[in]	sFileName	File name
[in]	pObjId	An OBJECTID_ATTRIBUTE structure.

Returns:

TRUE if success, FALSE otherwise

OBJIDLIB_API BOOL SetObjectIdExt	(	IN LPCWSTR	sFileName,
		IN POBJECTID_ATTRIBUTE	pObjId
	)

Set an extended part of an object id of a specified file.

Parameters:

[in]	sFileName	File name
[in]	pObjId	An OBJECTID_ATTRIBUTE structure containing an extended part. ObjectId member is ignored.

Returns:

TRUE if success, FALSE otherwise