DeleteNtmsDrive
[This is preliminary documentation and subject to change.]
The DeleteNtmsDrive function deletes a drive from the RSM database. The drive must have a dwOperationalState of NTMS_NOT_PRESENT.
DWORD WINAPI DeleteNtmsDrive(
HANDLE hSession,
LPNTMS_GUID lpDriveId
);
Parameters
-
hSession
-
Handle to the session returned by the OpenNtmsSession function.
-
lpDriveId
-
Specifies the unique identifier of a drive.
Return Values
-
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 invalid.
-
ERROR_INVALID_HANDLE
-
The session handle is invalid or missing.
-
ERROR_INVALID_LIBRARY
-
The drive library identifier is invalid.
-
ERROR_INVALID_PARAMETER
-
The media identifier is missing.
-
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 NTMS server.
QuickInfo
Windows NT: Requires version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in ntmsapi.h.
Import Library: Use ntmsapi.lib.
See Also
Library Control Functions