SetNtmsRequestOrder 함수(ntmsapi.h)
[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]
SetNtmsRequestOrder 함수는 지정된 요청이 라이브러리 큐에서 처리되는 순서를 설정합니다.
구문
DWORD SetNtmsRequestOrder(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId,
[in] DWORD dwOrderNumber
);
매개 변수
[in] hSession
OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.
[in] lpRequestId
라이브러리 요청의 고유 식별자입니다.
[in] dwOrderNumber
요청이 큐에서 처리되도록 주문합니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
컴퓨터에 대한 NTMS_CONTROL_ACCESS 거부되었습니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
Windows XP: 액세스 권한이 필요하지 않습니다. |
|
데이터베이스에 액세스할 수 없거나 손상되었습니다. |
|
세션 핸들이 없거나 잘못되었습니다. |
|
라이브러리 요청 식별자가 없습니다. |
|
지정된 식별자가 있는 요청 개체를 찾을 수 없습니다. |
|
함수가 성공했습니다. |
설명
현재 NTMS_LM_MOUNT 요청은 주문 번호를 사용하여 정렬됩니다.
SetNtmsRequestOrder 함수에서 설정한 주문 번호는 형식이 미리 결정된 순서로 처리되기 때문에 요청 형식과 관련이 있습니다. 예를 들어 NTMS_LM_DISMOUNT 요청은 NTMS_LM_MOUNT 요청 전에 처리됩니다. 그러나 특정 요청 클래스 내에서 큐를 정렬할 수 있습니다. 순서가 낮은 요청이 먼저 처리됩니다. 예를 들어 1은 처리된 첫 번째 요청이고, 2는 처리된 다음 요청입니다.
요청을 즉시 처리하려면 애플리케이션에서 주문 번호를 1로 설정할 수 있습니다. 처리를 연기하려면 애플리케이션에서 주문 번호를 매우 많은 수 또는 0xFFFFFFFF 설정해야 합니다. 현재 주문 번호가 0인 요청의 주문 번호는 변경할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |