CreateFileAsBinaryDataStorage - История изменений

Андрей Чусов в 06:05, 16 августа 2019

2019-08-16T06:05:01Z

← Предыдущая		Версия 16:05, 16 августа 2019
Строка 10:		Строка 10:
	{{function_end}}		{{function_end}}

	Возвращаемое представление источника данных имеет [[программный интерфейс]] [[IDataStorage]], который необходимо конкретизировать вызовами методов [[IDataStorage::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[IDataStorage::RepresentAs\|RepresentAs]] к конкретному типу. Гарантируется поддержка как минимум одного из интерфейсов [[IContiguousDataStorageInput]], [[IContiguousDataStorageOutput]] и/или [[IContiguousDataStorage]] в зависимости от значения параметра {{param\|nAccess}}. Элементом файлового накопителя, создаваемого функцией [[CreateFileAsBinaryDataStorage]] является байт, а потоки чтения и записи поддерживают интерфейсы [[IFileInputByteStream]] и [[IFileOutputByteStream]].		Возвращаемое представление источника данных имеет [[программный интерфейс]] [[IDataStorage]], который необходимо конкретизировать вызовами методов [[IDataStorage::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[IDataStorage::RepresentAs\|RepresentAs]] к конкретному типу. Гарантируется поддержка как минимум одного из интерфейсов [[IContiguousDataStorageInput]], [[IContiguousDataStorageOutput]] и/или [[IContiguousDataStorage]] в зависимости от значения параметра {{param\|nAccess}}. Элементом файлового накопителя, создаваемого функцией [[CreateFileAsBinaryDataStorage]], является байт, а потоки чтения и записи поддерживают интерфейсы [[IFileInputByteStream]] и [[IFileOutputByteStream]].

	Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IContiguousDataStorage::DeleteBlock]] или [[IContiguousDataStorage::EraseContent]]).		Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IContiguousDataStorage::DeleteBlock]] или [[IContiguousDataStorage::EraseContent]]).

Андрей Чусов в 06:04, 16 августа 2019

2019-08-16T06:04:33Z

← Предыдущая		Версия 16:04, 16 августа 2019
Строка 1:		Строка 1:
	{{function_begin \| return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin\|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
Строка 10:		Строка 10:
	{{function_end}}		{{function_end}}

	Возвращаемое представление источника данных имеет [[программный интерфейс]] [[IDataStorage]], который необходимо конкретизировать вызовами методов [[IDataStorage::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[IDataStorage::RepresentAs\|RepresentAs]] к конкретному типу. Гарантируется поддержка как минимум одного из интерфейсов [[IContiguousDataStorageInput]], [[IContiguousDataStorageOutput]] и/или [[IContiguousDataStorage]] в зависимости от значения параметра {{param\|nAccess}}.		Возвращаемое представление источника данных имеет [[программный интерфейс]] [[IDataStorage]], который необходимо конкретизировать вызовами методов [[IDataStorage::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[IDataStorage::RepresentAs\|RepresentAs]] к конкретному типу. Гарантируется поддержка как минимум одного из интерфейсов [[IContiguousDataStorageInput]], [[IContiguousDataStorageOutput]] и/или [[IContiguousDataStorage]] в зависимости от значения параметра {{param\|nAccess}}. Элементом файлового накопителя, создаваемого функцией [[CreateFileAsBinaryDataStorage]] является байт, а потоки чтения и записи поддерживают интерфейсы [[IFileInputByteStream]] и [[IFileOutputByteStream]].

	Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IContiguousDataStorage::DeleteBlock]] или [[IContiguousDataStorage::EraseContent]]).		Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IContiguousDataStorage::DeleteBlock]] или [[IContiguousDataStorage::EraseContent]]).

Андрей Чусов в 05:59, 16 августа 2019

2019-08-16T05:59:47Z

← Предыдущая		Версия 15:59, 16 августа 2019
Строка 10:		Строка 10:
	{{function_end}}		{{function_end}}

	Возвращаемое представление источника данных имеет [[программный интерфейс]] [[~~IBinaryDataBase~~]], который необходимо конкретизировать вызовами методов [[~~IBinaryDataBase~~::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[~~IBinaryDataBase~~::RepresentAs\|RepresentAs]] к конкретному типу.		Возвращаемое представление источника данных имеет [[программный интерфейс]] [[IDataStorage]], который необходимо конкретизировать вызовами методов [[IDataStorage::IsInterfaceAvailable\|IsInterfaceAvailable]] и [[IDataStorage::RepresentAs\|RepresentAs]] к конкретному типу. Гарантируется поддержка как минимум одного из интерфейсов [[IContiguousDataStorageInput]], [[IContiguousDataStorageOutput]] и/или [[IContiguousDataStorage]] в зависимости от значения параметра {{param\|nAccess}}.

	Возвращаемый через параметр <tt>ppDataStorage</tt> экземпляр источника данных ''может'' поддерживать интерфейсы произвольного доступа~~: [[IInputBinaryDataContiguousAccess]]~~, [[~~IOutputBinaryDataContiguousAccess~~]] или [[~~IIOBinaryDataContiguousAccess~~]] ~~(а также их базовые интерфейсы~~) ~~- в зависимости от разрешенного доступа~~.		Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IContiguousDataStorage::DeleteBlock]] или [[IContiguousDataStorage::EraseContent]]).

	Возможно открытие нескольких представлений для одного и того же файла. В случае разделения доступа к файлу, синхронизация доступа осуществляется средствами клиента. Гарантируется безопасное параллельное чтение из файла. Безопасность параллельной записи гарантируется лишь в случае, если изменяемые области файла не пересекаются, и размер файла в результате записи не изменяется (т.е. не осуществляется его увеличение при записи в/за конец файла или его уменьшение вызовом методов [[IOutputBinaryDataContiguousAccess::DeleteBlock]] или [[IIOBinaryDataContiguousAccess::DeleteBlock]]).		Каждый из успешно полученных экземпляров источника данных, включая экземпляры, полученные с помощью метода [[IDataStorage::RepresentAs\|RepresentAs]] необходимо закрывать вызовом соответствующего метода [[InterfaceBase::Release\|Release]].

	Каждый из успешно полученных экземпляров источника данных, включая экземпляры, полученные с помощью метода [[~~IBinaryDataBase~~::RepresentAs\|RepresentAs]] необходимо закрывать вызовом соответствующего метода [[InterfaceBase::Release\|Release]].

	Пример:		Пример:

	{{CreateFileAsBinaryDataStorage example}}		{{CreateFileAsBinaryDataStorage example}}

Андрей Чусов: Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.

2017-12-17T14:59:25Z

Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.

← Предыдущая		Версия 00:59, 18 декабря 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin \| return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}

Андрей Чусов в 20:49, 5 августа 2017

2017-08-05T20:49:40Z

← Предыдущая		Версия 06:49, 6 августа 2017
Строка 3:		Строка 3:
	{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
	{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}		{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}
	{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. ~~Значение~~ флагов: {{FileAccessMask}}}}		{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значения флагов: {{FileAccessMask}}}}
	{{function_paramlist add\|nCreationDisposition\|Метод создания файла. Может одно из следующих значений. {{FileCreationDisposition}}}}		{{function_paramlist add\|nCreationDisposition\|Метод создания файла. Может одно из следующих значений. {{FileCreationDisposition}}}}
	{{function_paramlist add\|ppDataStorage\|Указатель, который на выходе успешно завершившегося вызова принимает указатель на реализацию интерфейса [[IBinaryDataBase]], который по окончанию использования необходимо закрывать методом [[InterfaceBase::Release\|Release]]. В случае ошибки, выходное значение устанавливается в 0.\|paramdir=[out]}}		{{function_paramlist add\|ppDataStorage\|Указатель, который на выходе успешно завершившегося вызова принимает указатель на реализацию интерфейса [[IBinaryDataBase]], который по окончанию использования необходимо закрывать методом [[InterfaceBase::Release\|Release]]. В случае ошибки, выходное значение устанавливается в 0.\|paramdir=[out]}}

Андрей Чусов в 20:48, 5 августа 2017

2017-08-05T20:48:48Z

← Предыдущая		Версия 06:48, 6 августа 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* ~~pszFileName~~, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|~~pszFileName~~\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
	{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}		{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}
	{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значение флагов: {{FileAccessMask}}}}		{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значение флагов: {{FileAccessMask}}}}

Андрей Чусов в 21:23, 20 апреля 2017

2017-04-20T21:23:16Z

← Предыдущая		Версия 07:23, 21 апреля 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pszFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, ~~IBinaryDataBase~~** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pszFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pszFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pszFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}

Андрей Чусов в 06:23, 16 марта 2017

2017-03-16T06:23:10Z

← Предыдущая		Версия 16:23, 16 марта 2017
Строка 20:		Строка 20:
	Пример:		Пример:

	~~<source lang='cpp'>~~		{{CreateFileAsBinaryDataStorage example}}
	~~char l_filename[] = "./somefile";~~
	~~IIOBinaryData* pIO; //uninitialized pointer~~
	{
	~~IBinaryDataBase* pStorage; //uninitialized pointer~~
	~~int32_t err =~~ CreateFileAsBinaryDataStorage~~(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage));~~

	~~if (err < 0)~~
	~~return -1; //failure~~
	~~if (pStorage->IsInterfaceAvailable(IOBinaryDataType) == 1)~~
	~~return 0; //Interface is not available~~
	~~err = pStorage->RepresentAs(IOBinaryDataType, std::addressof(pIO));~~
	~~if (err < 0)~~
	~~return -1; //failure of RepresentAs~~
	}
	~~//access file via pIO...~~
	~~</source>~~

Андрей Чусов в 10:27, 15 марта 2017

2017-03-15T10:27:27Z

← Предыдущая		Версия 20:27, 15 марта 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pszFileName, std::size_t cbFileName, std::uint32_t nAccess, ~~FileCreationDisposition~~ nCreationDisposition, IBinaryDataBase** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pszFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IBinaryDataBase** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pszFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pszFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
Строка 25:		Строка 25:
	{		{
	IBinaryDataBase* pStorage; //uninitialized pointer		IBinaryDataBase* pStorage; //uninitialized pointer
	int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage)) ~~noexcept~~;		int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage));

	if (err < 0)		if (err < 0)

Андрей Чусов в 09:58, 15 марта 2017

2017-03-15T09:58:17Z

← Предыдущая		Версия 19:58, 15 марта 2017
Строка 17:		Строка 17:

	Каждый из успешно полученных экземпляров источника данных, включая экземпляры, полученные с помощью метода [[IBinaryDataBase::RepresentAs\|RepresentAs]] необходимо закрывать вызовом соответствующего метода [[InterfaceBase::Release\|Release]].		Каждый из успешно полученных экземпляров источника данных, включая экземпляры, полученные с помощью метода [[IBinaryDataBase::RepresentAs\|RepresentAs]] необходимо закрывать вызовом соответствующего метода [[InterfaceBase::Release\|Release]].

			Пример:

			<source lang='cpp'>
			char l_filename[] = "./somefile";
			IIOBinaryData* pIO; //uninitialized pointer
			{
			IBinaryDataBase* pStorage; //uninitialized pointer
			int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage)) noexcept;

			if (err < 0)
			return -1; //failure
			if (pStorage->IsInterfaceAvailable(IOBinaryDataType) == 1)
			return 0; //Interface is not available
			err = pStorage->RepresentAs(IOBinaryDataType, std::addressof(pIO));
			if (err < 0)
			return -1; //failure of RepresentAs
			}
			//access file via pIO...
			</source>

← Предыдущая		Версия 06:49, 6 августа 2017
Строка 3:		Строка 3:
	{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
	{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}		{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}
	{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. ~~Значение~~ флагов: {{FileAccessMask}}}}		{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значения флагов: {{FileAccessMask}}}}
	{{function_paramlist add\|nCreationDisposition\|Метод создания файла. Может одно из следующих значений. {{FileCreationDisposition}}}}		{{function_paramlist add\|nCreationDisposition\|Метод создания файла. Может одно из следующих значений. {{FileCreationDisposition}}}}
	{{function_paramlist add\|ppDataStorage\|Указатель, который на выходе успешно завершившегося вызова принимает указатель на реализацию интерфейса [[IBinaryDataBase]], который по окончанию использования необходимо закрывать методом [[InterfaceBase::Release\|Release]]. В случае ошибки, выходное значение устанавливается в 0.\|paramdir=[out]}}		{{function_paramlist add\|ppDataStorage\|Указатель, который на выходе успешно завершившегося вызова принимает указатель на реализацию интерфейса [[IBinaryDataBase]], который по окончанию использования необходимо закрывать методом [[InterfaceBase::Release\|Release]]. В случае ошибки, выходное значение устанавливается в 0.\|paramdir=[out]}}

← Предыдущая		Версия 06:48, 6 августа 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* ~~pszFileName~~, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}		{{function_begin \| return_code_t CreateFileAsBinaryDataStorage(const char* pFileName, std::size_t cbFileName, std::uint32_t nAccess, std::uint32_t nCreationDisposition, IDataStorage** ppDataStorage) noexcept; \|{{CreateFileAsBinaryDataStorage brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|~~pszFileName~~\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}		{{function_paramlist add\|pFileName\|Имя файла, заданное UTF-8 строкой.\|paramdir=[in]}}
	{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}		{{function_paramlist add\|cbFileName\|Размер имени файла, в байтах.}}
	{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значение флагов: {{FileAccessMask}}}}		{{function_paramlist add\|nAccess\|Битовая маска флагов запрашиваемого доступа к файлу. Значение флагов: {{FileAccessMask}}}}