3.2.5.2.5.6 INtmsSession1::WaitForNtmsOperatorRequest (Opnum 8)

  • Article

The WaitForNtmsOperatorRequest method waits for an operator request.

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

lpRequestId: A pointer to the identifier of the request for which to wait.

dwTimeout: The number of milliseconds to wait. To check for an operator request, specify a time-out value of 0. If a value of 0xFFFFFFFF is specified, this method does not time out.

Return value/code

Description

0x00000000

S_OK

The call was successful.

0x80070005

ERROR_ACCESS_DENIED

Access to one or more objects is denied.

0x80070057

ERROR_INVALID_PARAMETER

An invalid parameter was found.

0x800704C7

ERROR_CANCELLED

The operator request was canceled by an administrator.

0x800705B4

ERROR_TIMEOUT

The time specified in the dwTimeout parameter elapsed before completion of the operator request.

0x800708CA

ERROR_NOT_CONNECTED

Unable to connect to the service.

0x800710D8

ERROR_OBJECT_NOT_FOUND

Unable to find the operator request object. Object requests are flushed from the database.

Upon receiving this message, the server MUST verify that lpRequestId is not NULL. If parameter validation fails, the server MUST immediately fail the operation and return ERROR_INVALID_PARAMETER (0x80070057).

This method MUST wait for an operator request to complete or be refused, and return when the request is completed or refused appropriately.

The method MUST return a time-out error if the request is not completed or not refused in dwTimeout.