nf-ntmsapi-deletentmsdrive.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:ntmsapi.DeleteNtmsDrive	DeleteNtmsDrive function (ntmsapi.h)	The DeleteNtmsDrive function deletes a drive from the RSM database. The drive must have a dwOperationalState of NTMS_NOT_PRESENT.	DeleteNtmsDrive DeleteNtmsDrive function [Files] _zaw_deletentmsdrive base.deletentmsdrive fs.deletentmsdrive ntmsapi/DeleteNtmsDrive	fs\deletentmsdrive.htm	fs	301900a1-9ccb-45ed-aba7-c398cda7d4a8	12/05/2018	DeleteNtmsDrive, DeleteNtmsDrive function [Files], _zaw_deletentmsdrive, base.deletentmsdrive, fs.deletentmsdrive, ntmsapi/DeleteNtmsDrive	ntmsapi.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Ntmsapi.lib	Ntmsapi.dll		Windows			19H1	DeleteNtmsDrive ntmsapi/DeleteNtmsDrive	c++	APIRef kbSyntax	DllExport	Ntmsapi.dll	DeleteNtmsDrive

DeleteNtmsDrive function

-description

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

The DeleteNtmsDrive function deletes a drive from the RSM database. The drive must have a dwOperationalState of NTMS_NOT_PRESENT.

-parameters

-param hSession [in]

Handle to the session returned by the OpenNtmsSession function.

-param lpDriveId [in]

Unique identifier of a drive.

-returns

This function returns one of the following values.

Value	Meaning
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS to the library is denied. Other security errors are also possible, but they would indicate a security subsystem error.
ERROR_DATABASE_FAILURE	The database is inaccessible or damaged.
ERROR_DATABASE_FULL	The database is full.
ERROR_INVALID_DRIVE	The drive identifier is not valid.
ERROR_INVALID_HANDLE	The session handle is missing or is not valid.
ERROR_INVALID_LIBRARY	The drive library identifier is not valid.
ERROR_NOT_ENOUGH_MEMORY	An allocation failure occurred during processing.
ERROR_SUCCESS	The function was successful.

-remarks

You can use this function to remove drives that are no longer connected to the RSM server.

-see-also

Library Control Functions