Код элемента управления IOCTL_VOLUME_IS_CSV
Определяет, является ли том томом CSV.
Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to device
IOCTL_VOLUME_IS_CSV, // dwIoControlCode
NULL, // input buffer
0, // size of input buffer
(LPVOID) lpOutBuffer, // lpOutBuffer
(DWORD) nOutBufferSize, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure
Параметры
-
hDevice
-
Дескриптор тома. Чтобы получить дескриптор тома, вызовите функцию CreateFile . Только администраторы могут открывать дескрипторы томов.
-
dwIoControlCode
-
Код элемента управления для операции. Используйте IOCTL_VOLUME_IS_CSV для этой операции.
-
lpInBuffer
-
Не используется с этой операцией; для параметра задано значение NULL.
-
nInBufferSize
-
Не используется с этой операцией; значение равно нулю (0).
-
lpOutBuffer
-
Указатель на TRUE , если том является томом CSV; В противном случае вызов функции завершается ошибкой.
-
nOutBufferSize
-
Размер выходного буфера в байтах.
-
lpBytesReturned
-
Указатель на переменную, которая получает размер данных, хранящихся в выходном буфере, в байтах.
Если lpOverlapped имеет значение NULL, lpBytesReturned не может иметь значение NULL. Даже если операция не возвращает выходные данные и lpOutBuffer имеет значение NULL, DeviceIoControl использует lpBytesReturned. После такой операции значение lpBytesReturned не имеет смысла.
Если значение lpOverlapped не равно NULL, lpBytesReturned может иметь значение NULL. Если этот параметр не равен NULL и операция возвращает данные, функция lpBytesReturned не имеет смысла до завершения перекрывающейся операции. Чтобы получить количество возвращенных байтов, вызовите Метод GetOverlappedResult. Если hDevice связан с портом завершения ввода-вывода, можно получить количество возвращаемых байтов, вызвав Метод GetQueuedCompletionStatus.
-
lpOverlapped
-
Указатель на структуру OVERLAPPED .
Если hDevice был открыт без указания FILE_FLAG_OVERLAPPED, lpOverlapped игнорируется.
Если hDevice был открыт с флагом FILE_FLAG_OVERLAPPED , операция выполняется как перекрываемая (асинхронная) операция. В этом случае lpOverlapped должен указывать на допустимую структуру OVERLAPPED , содержащую дескриптор объекта события. В противном случае функция завершается сбоем непредсказуемым образом.
Для перекрывающихся операций DeviceIoControl возвращает немедленно, и объект события получает сигнал о завершении операции. В противном случае функция не возвращается, пока операция не будет завершена или не возникнет ошибка.
Возвращаемое значение
Если операция завершается успешно, DeviceIoControl возвращает ненулевое значение.
Если операция завершается сбоем или находится в состоянии ожидания, DeviceIoControl возвращает ноль (0). Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Ни одна версия не поддерживается |
| Минимальная версия сервера |
Windows Server 2012 [только классические приложения] |
| Заголовок |
|