WaitForNtmsOperatorRequest 함수(ntmsapi.h)

[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]

WaitForNtmsOperatorRequest 함수는 지정된 RSM 연산자 요청을 기다립니다.

구문

DWORD WaitForNtmsOperatorRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwTimeout
);

[in] hSession

OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.

[in] lpRequestId

SubmitNtmsOperatorRequest 함수에서 만든 연산자 요청 식별자입니다.

[in] dwTimeout

대기할 시간(밀리초)입니다. 연산자 요청에 대한 검사 시간 제한 값을 0으로 전달합니다. INFINITE 값을 지정하는 경우 이 함수는 제한 시간을 초과하지 않습니다.

이 함수는 다음 값 중 하나를 반환합니다.

값	의미
ERROR_CANCELLED	운영자 요청이 관리자에 의해 취소되었습니다.
ERROR_INVALID_HANDLE	hSession 매개 변수에 지정된 값이 NULL이거나 유효하지 않습니다.
ERROR_INVALID_PARAMETER	매개 변수 값 중 하나가 잘못되었습니다.
ERROR_NOT_CONNECTED	RSM 서비스에 연결할 수 없습니다.
ERROR_OBJECT_NOT_FOUND	연산자 요청 개체를 찾을 수 없습니다. 개체 요청은 데이터베이스에서 플러시됩니다. RSM이 이 오류를 반환하는 경우 애플리케이션은 AllocateNtmsMedia 와 같은 함수를 호출해야 합니다.
ERROR_SUCCESS	함수가 성공했습니다.
ERROR_TIMEOUT	연산자 요청이 완료되기 전에 dwTimeout 매개 변수에 지정된 시간이 경과된 시간입니다.

WaitForNtmsOperatorRequest 함수로 지정된 연산자 요청은 미디어를 요청하거나, 미디어를 한 라이브러리에서 다른 라이브러리로 이동하도록 요청하거나, RSM 디바이스 서비스를 요청하는 데 사용됩니다.

애플리케이션은 WaitForNtmsOperatorRequest 를 사용하여 운영자 요청의 해결을 기다립니다. 요청을 충족, 거부, 삭제 또는 시간 초과할 수 있습니다.

일반적으로 애플리케이션은 SubmitNtmsOperatorRequest 함수를 사용하여 연산자 요청을 제출하고 WaitForNtmsOperatorRequest 함수를 사용하여 해결을 기다립니다.